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ABSTRACT 


The  Computer-Aided  Prototyping  System  (CAPS)  is  an  integrated  collection 
of  software  tools  that  support  the  development  of  software  systems  utilizing  the  pro- 
totype paradigm.  Central  to  CAPS  is  the  Prototype  System  Description  Language 
(PSDL).  The  PSDL  Editor  supplied  in  CAPS  Release  1  provided  a  unique  combina- 
tion of  a  graphical  interface  for  editing  PSDL  data  flow  diagrams  and  an  attribute- 
grammar  based  text  editor  to  enforce  syntactically  correct  PSDL  prototypes.  Feed- 
back from  CAPS  users  highlighted  on  productivity  impacts  due  to  the  dual  user 
interface  as  well  as  the  steep  learning  curve  required  to  become  proficient  with  the 
attribute-grammar  based  text  editor. 

This  research  initiates  the  development  of  the  next  generation  of  the  CAPS 
PSDL  Editor,  focusing  on  the  graph  editor.  Our  approach  provides  a  single  graphical 
user  interface  with  pull-down  menus  for  editing  both  graphical  and  text  information. 
Automatic  syntax  generation  and  validation  as  well  as  limited  semantic  validation  is 
provided  by  a  background  syntax/semantics  checker.  The  result  of  this  research  is 
a  working  graph  editor  meeting  all  the  new  requirements.  When  integrated  with  a 
the  new  syntax/semantics  checker,  CAPS  Release  2  will  have  a  PSDL  Editor  with 
enhanced  capabilities  and  expected  productivity  improvements. 
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DISCLAIMER 

The  computer  programs  provided  in  the  appendices  are  supplied  on  an  "as  is" 
basis,  with  no  warrantees  of  any  kind.  The  author  bears  no  responsibility  for  any 
consequences  of  using  these  program. 
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I. 


INTRODUCTION 


A.   BACKGROUND 

The  Computer-Aided  Prototyping  System  (CAPS)  [Ref.  1]  is  an  integrated 
collection  of  software  tools  that  support  the  development  of  software  systems  using 
the  prototyping  paradigm.  The  focus  of  CAPS  is  the  development  of  hard  real-time 
embedded  software  systems  [Ref.  2].  Through  the  use  of  the  prototyping  paradigm, 
CAPS  is  especially  well  suited  to  support  the  development  and  validation  of  system 
requirements  as  well  as  feasibility  studies  [Ref.  3]. 

The  software  tools  that  comprise  CAPS  are  organized  into  four  major  subsys- 
tems: Editors,  Software  Base,  Execution  Support,  and  Project  Control  (see  Figure  1) 
[Ref.  4].  Underlying  each  of  these  subsystems  is  the  Prototype  System  Description 
Language  (PSDL)  [Ref.  3]. 

Prototypes  developed  in  CAPS  are  specified  using  PSDL.  PSDL  is  a  high- 
level  language,  rich  in  abstraction  and  with  facilities  for  capturing  the  requirements 


Figure  1.  CAPS  Subsystems,  After  [Ref.  4] 


of  real-time  systems.  In  PSDL,  a  prototype  is  partially  specified  as  an  augmented 
data  flow  diagram.  A  representation  of  a  PSDL  prototype  is  provided  in  Figure  2. 
The  augmented  data  flow  diagram  is  depicted  by  the  shaded  box  at  the  top  of  the 
figure. 

A  data  flow  diagram  consists  of  a  network  of  operators  which  communicate 
through  data  streams.  The  data  flow  diagram  depicted  in  Figure  2  is  composed 
of  three  operators  (represented  as  circles)  and  two  data  streams  (represented  as  the 
directed-lines  connecting  the  circles  within  the  shaded  box).  The  data  flow  diagram  is 
augmented  with  timing  and  control  constraints.  In  Figure  2,  each  operator  is  assigned 
a  Maximum  Execution  Time  (MET),  which  can  be  found  at  the  bottom-right  of  each 
operator.  In  this  example,  all  MET  values  are  in  milliseconds  (ms). 

A  data  flow  diagram  is  one  element  of  a  PSDL  component.  PSDL  provides 
two  kinds  of  components:  abstract  state  machines  and  abstract  data  types.  An  aug- 
mented data  flow  diagram  is  a  visual  abstraction  of  the  processing  to  be  performed  by 
an  operator.  Operators  are  introduced  through  PSDL  components.  An  abstract  state 
machine  specifies  a  single  operator.  Multiple  operators  can  be  introduced  as  part  of 
an  abstract  data  type.  The  prototype  itself  is  implemented  as  an  operator  defined  by 
an  abstract  state  machine.  There  are  two  parts  to  each  component:  a  specification 
and  an  implementation.  The  specification  defines  the  component's  interface.  The 
component's  implementation  can  be  realized  by  either  decomposing  the  component 
into  a  more  detailed  data  flow  diagram  or  by  a  reference  to  a  programming  language 
implementation.  Figure  2  depicts  the  top  level  data  flow  diagram  of  a  robot  proto- 
type. In  this  example,  each  operator  has  been  implemented  with  a  reference  to  a 
programming  language  implementation,  illustrated  by  the  three  boxes  below  the  aug- 
mented data  flow  diagram.  The  current  release  of  CAPS  supports  two  programming 
language  implementations.  An  operator  can  be  implemented  as  an  Ada  package  or 
as  a  TAE  module,  providing  a  graphical  interface.  [Ref.  5] 

The  Editor  subsystem  provides  a  collection  of  editors  which  are  tailored  to  the 
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Figure  2.  PSDL  Data  Flow  Diagram  and  Implementation 


ingredients  of  a  CAPS  prototype.  The  primary  CAPS  editor  is  the  PSDL  Editor. 
This  editor  is  unique  to  CAPS  and  has  been  designed  specifically  for  the  development 
of  PSDL  prototypes.  A  graphical  interface  to  support  the  data  flow  diagram  as  well 
as  syntax  generation  and  checking  facilitate  improved  user  efficiency  in  prototype 
development.  Other  editors  are  provided  to  edit  the  Ada  packages  and  the  TAE 
graphical  interfaces  which  realize  the  prototype. 

The  Software  Base  subsystem  provides  CAPS  with  a  repository  of  reusable 
prototype  components.  Facilities  are  provided  to  browse  as  well  as  query  the  compo- 
nent repository.  Queries  can  be  performed  using  the  PSDL  component  specification. 


[Ref.  6] 

The  Execution  Support  subsystem  is  one  of  the  key  features  of  CAPS  which 
allows  for  rapid  prototyping  of  real-time  systems.  The  Execution  Support  subsystem 
provides  for  the  automatic  generation  of  "supervisory"  code  based  on  the  PSDL 
specification  of  the  prototype.  The  "supervisory"  code  provides  scheduling  of  time 
critical  and  non-time  critical  operators,  implements  buffered  communication  paths 
(e.g.,  data  streams)  with  applicable  initial  values,  implements  the  control  constraints 
specified  in  the  prototype,  and  provides  support  for  timers  and  exception  handling. 
All  of  which  is  automatically  implemented  by  CAPS. 

The  Project  Control  subsystem  provides  advanced  project  capabilities.  The 
Evolution  Control  System  facilitates  prototype  development  in  a  team  environment. 
The  CAPS  Merger  provides  an  automated  tool  for  change-merging  of  PSDL  compo- 
nents. [Ref.  6] 

CAPS  has  been  an  ongoing  research  area  at  the  Naval  Postgraduate  School 
(NPS)  for  nearly  ten  years.  During  this  time,  CAPS  has  been  used  to  develop  a 
variety  of  student  projects  and  theses,  including  an  autopilot  system,  a  cruise  missile 
guidance  system,  and  a  Communications,  Command  and  Control  Information  warfare 
(C3I)  system.  The  current  version  of  CAPS  is  Release  1.  [Ref.  7] 

B.      CAPS  RELEASE  1  PSDL  EDITOR 

The  PSDL  Editor  provided  in  CAPS  Release  1  facilitated  the  full  specifica- 
tion of  a  prototype  in  PSDL  (refer  to  Appendix  A  for  the  definition  of  the  PSDL 
grammar).  Departing  from  typical  editors,  the  PSDL  Editor  provided  facilities  to 
view  and  edit  the  PSDL  augmented  data  flow  diagram  in  its  most  natural  form,  a 
graph  (this  functionality  will  be  referred  to  as  the  "graph  editor"  in  this  document). 
However,  the  graph  editor  was  limited  in  its  capabilities  to  fully  specify  a  prototype. 
The  graph  editor  provided  for  the  entry  of  the  PSDL  data  flow  diagram  along  with 
associated  labels  (i.e.,  operator  and  data  stream  names).  In  order  to  maintain  a  sim- 


pie  abstraction  of  the  processing  to  be  performed,  the  PSDL  properties1  displayed  on 
the  augmented  data  flow  diagram  were  limited  to  those  deemed  most  critical.  For 
operators,  the  MET  was  supported.  For  data  streams,  the  graph  editor  provided  for 
the  selection  between  a  data  stream  and  a  state  stream  as  well  as  for  any  stream 
latency.  The  remainder  of  the  PSDL  specification  was  supported  through  the  use  of 
a  text  editor. 

Once  again,  the  CAPS  designers  departed  from  typical  editors  with  the  in- 
clusion of  a  syntax-directed  editor  to  facilitate  the  required  text  editing.  A  syntax- 
directed  editor  is  a  language-based  editor.  With  knowledge  of  a  language's  syntax,  a 
syntax-directed  editor  is  capable  of  detecting  and  locating  syntax  errors.  For  CAPS, 
this  means  that  PSDL  syntax  errors  can  be  corrected  in  the  editor  rather  than  wait- 
ing for  them  to  be  detected  by  the  Execution  Support  subsystem.  In  addition,  a 
syntax-directed  editor  can  provide  the  user  with  templates  for  structures  within  the 
language.  The  syntax-directed  editor  provided  in  CAPS  Release  1  was  implemented 
using  the  Synthesizer  Generator,  a  commercial  product  developed  by  Thomas  Reps 
and  Tim  Teitelbaum  [Ref.  8]. 

Provided  with  a  definition  of  a  language's  abstract  syntax,  context-sensitive 
relationships,  display  format,  concrete  input  syntax,  and  transformation  rules,  the 
Synthesizer  Generator  produces  a  language-based  editor.  Fundamental  to  the  opera- 
tion of  the  Synthesizer  Generator  is  the  use  of  an  attribute  grammar.  An  attribute 
grammar  is  obtained  by  the  addition  of  attributes  to  the  nonterminal  symbols  of  a 
context-free  grammar  along  with  a  set  of  attribute  equations.  As  an  object  is  edited 
with  a  syntax-directed  editor  (created  by  the  Synthesizer  Generator),  the  object  is 
represented  internally  by  a  derivation  tree,  which  is  based  on  the  attribute  grammar. 
It  is  the  derivation  tree  which  is  traversed  and  modified  through  editing  operations. 
[Ref.  8] 


1PSDL  properties  will  be  discussed  in  Chapter  II.  For  the  present,  the  MET  and  the  Latency 
are  timing  requirements  of  the  prototype.  A  state  stream  is  a  special  case  of  a  data  stream  which 
provides  the  prototype  with  memory. 


In  the  CAPS  Release  1  PSDL  Editor,  the  graph  editor  and  the  syntax-directed 
editor  were  merged  together  to  provide  an  integrated  tool  to  facilitate  the  development 
of  prototypes.  The  PSDL  Editor  was  implemented  by  executing  the  syntax-directed 
editor  and  the  graph  editor  in  separate  processes.  The  syntax-directed  editor  was 
the  parent  process.  Two  copies  of  the  graph  editor  were  executed,  each  in  its  own 
process.  Upon  startup  of  the  syntax-directed  editor,  the  first  copy  of  the  graph  editor 
was  created  as  a  graph  viewer.  As  the  PSDL  prototype  was  traversed  in  the  syntax- 
directed  editor,  the  graph  viewer  displayed  the  applicable  data  flow  diagram.  In  order 
to  edit  the  data  flow  diagram,  a  second  copy  of  the  graph  editor  was  created  as  a 
graph  editor. 

The  implementation  of  the  CAPS  Release  1  PSDL  Editor  resulted  in  the  cre- 
ation of  an  artificial  boundary  between  the  data  flow  diagram  and  the  associated 
PSDL  properties.  This  artificial  boundary  resulted  in  a  two  step  process  of  proto- 
type development  for  the  typical  CAPS  user.  In  this  process,  the  user  would  create 
the  data  flow  diagram  of  the  prototype  using  the  graph  editor  (reference  Figure  32). 
When  the  data  flow  diagram  was  reasonably  complete,  the  user  would  return  to  the 
syntax-directed  editor  (reference  Figure  4),  where  the  associated  properties  would  be 
entered. 

The  separation  between  the  syntax-directed  editor  and  the  graph  editor  fos- 
tered a  single  mind-set  of  operation  in  which  all  of  the  data  flow  diagram  was  entered 
prior  to  the  use  of  the  syntax-directed  editor  to  enter  the  associated  properties.  State 
streams  presented  a  large  potential  for  error.  If  a  user  specified  a  state  stream  in  the 
data  flow  diagram  through  the  graph  editor,  the  state  stream  was  not  implemented 
until  the  user  again  specified  the  state  stream  in  the  syntax-directed  editor. 

The  templates  available  in  the  syntax-directed  editor  provided  assistance  to 
the  user  in  developing  a  syntactically  correct  prototype.  At  each  stage  of  a  prototype's 
development,  the  syntax-directed  editor  was  capable  of  prompting  the  user  for  the 


!This  prototype  is  taken  from  the  avionics_example  found  in  Appendix  B. 


Figure  3.  CAPS  Release  1  Graph  Editor 
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Figure  4.  CAPS  Release  1  Syntax-Directed  Editor 


legal  alternatives  within  the  PSDL  grammar  (refer  to  the  bottom  of  Figure  4).  In 
addition,  the  knowledge  of  templates  enabled  the  syntax-directed  editor  to  perform 
operations  on  entire  structures,  made  available  to  the  user  from  the  Structure  menu 
(refer  to  the  top  of  Figure  4). 

However,  due  to  differences  between  the  attribute  grammar  programmed  into 
the  syntax-directed  editor  and  the  PSDL  grammar  definition  (refer  to  Appendix  A), 
the  traversal  of  the  derivation  tree  maintained  by  the  syntax-directed  editor  was  not 
always  intuitive  to  the  user.  In  some  cases,  additional  nodes  were  inserted  into  the 
derivation  tree  which  confused  the  user.  In  order  to  become  proficient  with  the  PSDL 
Editor,  the  user  was  required  to  become  familiar  with  the  unique  features  of  the 
attribute  grammar. 

A  typical  example  is  the  editing  of  a  type_declaration  within  a  data  stream 
structure.  Figure  5  depicts  a  graphical  representation  of  the  type_declaration  struc- 
ture from  the  PSDL  grammar  definition  (starting  with  line  25  of  Appendix  A).  Fig- 
ure 6  depicts  how  the  same  structure  would  be  represented  in  the  derivation  tree  of 
the  syntax-directed  editor,  based  on  the  attribute  grammar.  The  derivation  tree 
provided  additional  nodes  to  represent  the  set  of  types  which  were  allowed  INTEGER, 
REAL,  BOOLEAN,  and  UserJDef  ined.  However,  the  definition  of  the  attribute  gram- 
mar was  not  intuitive  to  the  typical  CAPS  user.  Figure  7  depicts  four  snapshots 
of  the  syntax-directed  editor  in  an  example  where  the  user  wishes  to  modify  the 
type  used  for  the  data  stream  av_consent_switch.  Initially,  the  data  stream  is 
of  type  switch_position,  a  User_Def  ined  type.  The  required  type  for  the  data 
stream  is  BOOLEAN.  The  user  selects  the  type  name,  depicted  by  the  underlined 
switch_position  in  the  first  snapshot.  The  user  deletes  this  entry  and  expects 
to  be  presented  with  the  decl_type_name  options.  However,  syntax-directed  editor 
is  still  located  at  the  id  node  below  DTypeUserDef  ined  within  the  derivation  tree 
(refer  to  the  second  snapshot).  The  user  is  required  to  ascend  to  the  parent  (i.e., 
decl_type_name)  from  the  Structure  menu  and  cut  off  the  existing  branch  of  the 
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type_name 


Figure  5.  PSDL  Type  Declaration 


derivation  tree  from  the  Edit  menu  (depicted  in  the  third  snapshot).  The  syntax- 
directed  editor  is  now  positioned  within  the  derivation  tree  to  prompt  for  the  BOOLEAN 
option,  which  is  selected  and  depicted  in  the  fourth  snapshot. 

Additionally,  the  syntax-directed  editor's  attribute  grammar  stipulates  an  or- 
der in  which  PSDL  structures  can  be  arranged.  In  some  cases,  this  order  is  defined 
in  the  PSDL  grammar.  In  other  cases,  it  is  solely  defined  by  the  syntax-directed  edi- 
tor. Regardless  of  the  PSDL  grammar,  the  syntax-directed  editor  requires  a  specific 
ordering  of  PSDL  structures.  The  syntax-directed  editor  provides  the  user  assistance 
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Figure  6.  Derivation  Tree  Type  Declaration 
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by  prompting  for  all  valid  constructs  at  the  cursor  location.  However,  the  user  is  re- 
quired to  either  memorize  the  order  stipulated  by  the  attribute  grammar  or  to  search 
through  the  prototype  in  order  to  identify  the  location  for  the  desired  construct. 

C.      RESEARCH  GOAL 

While  the  PSDL  Editor  provided  advanced  features  for  specifying  the  require- 
ments of  a  prototype  in  PSDL,  it  also  introduced  artificial  boundaries  and  linear  con- 
straints that  impacted  a  users  productivity.  The  goal  of  this  research  is  to  develop  the 
next  generation  of  the  PSDL  Editor  in  an  attempt  to  overcome  these  impediments. 

As  this  research  was  envisioned,  the  development  of  the  next  generation  of  the 
PSDL  Editor  was  divided  between  the  graph  editor  and  a  background  checker  driver, 
written  in  Ada.  This  research  was  centered  about  the  graph  editor.  This  project  was 
implemented  as  an  evolutionary  task.  The  CAPS  Release  1  graph  editor  was  used 
as  the  baseline  from  which  this  research  was  initiated.  Additional  work  on  the  graph 
editor  was  accomplished  partly  through  the  class  project  for  NPS  CS4520  (AY96Q4). 
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II.         PROTOTYPE  SYSTEM  DESCRIPTION 

LANGUAGE  (PSDL) 

The  primary  reference  for  the  Prototype  System  Description  Language  is  the 
paper  UA  Prototyping  Language  for  Real-Time  Software"  by  Luqi,  Berzins,  and  Yeh 
[Ref.  3];  which  describes  the  semantics  of  PSDL.  Refinements  to  the  PSDL  seman- 
tics are  outlined  in  Professor  Luqi's  class  notes  from  the  Naval  Postgraduate  School 
course  CS4920:  Computer  Aided  Prototyping  Systems  (AY96Q3)  [Ref.  9].  These  two 
sources,  along  with  the  PSDL  syntax  provided  as  Appendix  A,  define  PSDL. 

This  chapter  provides  an  introduction  to  PSDL  as  background  information  for 
a  discussion  of  the  PSDL  Editor.  Here  PSDL  is  described  within  the  context  of  a 
CAPS  tool  set  implementation.  This  serves  two  purposes.  First,  a  background  in 
PSDL  is  necessary  in  order  to  understand  the  required  operation  of  the  PSDL  Editor. 
CAPS  provides  a  language-sensitive  editor.  The  PSDL  Editor  is  solely  dedicated 
to  CAPS,  incorporating  many  language  dependent  features  designed  to  simplify  the 
specification  of  a  PSDL  prototype.  Second,  this  introduction  serves  to  inform  the 
CAPS  user  of  limitations  imposed  by  a  CAPS  implementation  which  deviate  from 
the  PSDL  semantics. 

CAPS  provides  a  set  of  integrated  tools  (reference  Figure  1)  designed  to  facil- 
itate the  development  of  executable  prototypes  using  PSDL.  Limitations  within  the 
tool  set  have  resulted  in  a  CAPS  implementation  that  does  not  fully  comply  with  the 
PSDL  semantics.  With  each  new  release  of  CAPS,  an  attempt  is  made  to  remove 
these  limitations.  This  research  effort  comes  between  CAPS  implementations.  Cur- 
rently, CAPS  is  at  Release  1.  Release  2  is  planned,  but  not  yet  fully  defined  for  all 
CAPS  subsystems.  Release  2  does  contain  PSDL  syntax  changes.  These  changes  are 
reflected  in  this  introduction  as  well  as  in  the  next  release  of  the  PSDL  Editor.  How- 
ever, any  changes  which  may  be  incorporated  into  the  Execution  Support  subsystem 
tools  (excluding  those  changes  needed  to  support  the  new  PSDL  syntax)  are  unde- 
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fined  at  this  time,  and  hence  are  not  addressed  here.  Thus,  the  PSDL  configuration 
which  is  addressed  here  is  the  CAPS  Release  1  implementation  with  the  addition  of 
the  CAPS  Release  2  updated  syntax.  As  a  result  of  the  syntax  changes  which  will 
make  up  CAPS  Release  2,  prototypes  developed  with  this  PSDL  Editor  will  not  be 
compatible  with  CAPS  Release  1. 

Since  CAPS  users  are  presented  with  an  implementation  which  does  not  fully 
support  the  PSDL  semantics,  users  could  potentially  design  a  prototype  which  utilizes 
a  limitation.  Limitations  with  an  implementation  require  special  consideration  by  the 
prototype  developer  and  may  require  the  designer  to  over-constrain  the  prototype 
in  order  to  work  around  a  limitation.  For  example,  within  the  PSDL  semantics, 
stream  names  are  local.  However,  the  CAPS  Release  1  implementation  operates  as  if 
stream  names  are  global.  In  order  to  maintain  the  semantics  of  PSDL,  a  prototype 
designer  must  over-constrain  the  prototype  by  forcing  unique  stream  names  in  order 
to  maintain  local  streams. 

Thus,  concessions  must  be  made  in  the  prototype  design  to  make  up  for  limi- 
tations in  the  support  provided  by  the  tools.  The  concessions  provided  here  are  in  full 
compliance  with  the  PSDL  syntax.  They  simply  over-constrain  the  design  in  order 
to  work  around  a  limitation.  Prototypes  which  adhere  to  these  concessions  should 
be  compliant  with  future  releases  of  CAPS.  Prototypes  which  do  not  adhere  to  the 
correct  semantics  of  PSDL  will  most  likely  "break"  in  future  releases. 

A.      PSDL  PROTOTYPE 

Figure  8  depicts  the  partial  taxonomy  of  a  PSDL  prototype.  A  PSDL  pro- 
totype consists  of  a  set  of  components.  PSDL  provides  two  kinds  of  components: 
abstract  state  machines  and  abstract  data  types.  An  operator  is  an  instance  of  an 
abstract  state  machine  and  can  be  introduced  into  the  prototype  by  either  an  ab- 
stract state  machine  component  or  an  operator  of  an  abstract  data  type  component. 
In  PSDL,  the  operator  is  the  basic  computational  entity  [Ref.  10]. 
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A  prototype  is  decomposed  into  a  network  of  operators  which  communicate 
through  data  streams.  Data  streams  carry  objects  of  a  fixed  data  type.  Data  stream 
objects  can  be  either  predefined  data  types  or  types  defined  by  abstract  data  type 
components. 

The  PSDL  syntax  provides  for  the  description  of  this  network  as  a  data  flow  di- 
agram in  which  the  vertices  represent  operators  and  the  edges  represent  data  streams. 
By  itself,  the  data  flow  diagram  is  not  sufficient  to  support  the  definition  of  a  real-time 
system.  PSDL  augments  the  data  flow  diagram  with  control  and  timing  constraints. 
The  augmented  data  flow  diagram  together  with  a  set  of  precedence  rules  provides 
sufficient  information  for  the  CAPS  Execution  Support  subsystem  to  automatically 
generate  the  "supervisory"  code  used  to  control  the  execution  and  communications 
of  operators. 

While  the  operator  is  the  PSDL  computational  entity,  the  PSDL  syntax  does 
not  provide  for  the  complete  implementation  of  all  operators.  A  general  purpose 
programming  language  is  required  to  implement  some  operators3.  Currently,  CAPS 
supports  the  programming  languages  Ada  and  TAE  to  implement  operators.  CAPS 
generates  Ada  code  for  "supervisory"  control. 

The  "supervisory"  code  generated  by  the  CAPS  Execution  Support  subsystem 
controls  the  execution  of  PSDL  operators.  As  can  be  seen  from  Figure  8,  PSDL 
contains  both  time  critical  and  non-time  critical  operators.  Time  critical  operators 
are  controlled  by  a  static  schedule.  Non-time  critical  operators  are  controlled  by  a 
dynamic  schedule.  The  static  schedule  is  executed  as  a  high  priority  Ada  task.  The 
dynamic  schedule  is  executed  as  a  lower  priority  Ada  task  that  runs  whenever  the 
static  schedule  idles.  [Ref.  9] 


3  Operators  which  are  implemented  using  a  general  purpose  programming  language  are  called 
atomic  operators. 
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Figure  9.  State  Machine  example 

1.  Component  Structure 

Every  PSDL  component  is  made  up  of  two  parts:  a  specification  and  an  im- 
plementation. The  specification  defines  the  component's  interface  and  provides  for 
the  documentation  of  behavior  and  requirements  tracing.  The  implementation  can 
be  performed  using  a  PSDL  supported  programming  language  (for  atomic  operators) 
or  further  defined  in  PSDL  (for  composite  operators). 

2.  Abstract  State  Machines 

A  PSDL  operator  is  a  state  machine.  A  state  machine  contains  a  finite  number 
of  inputs,  outputs,  and  state  variables;  each  of  which  are  represented  as  a  data  stream. 
Figure  9  provides  an  example  of  a  state  machine  with  two  input  streams  (x  and  y), 
one  output  stream  (z),  and  one  state  variable4  (sv).  A  function  is  a  state  machine 
with  no  state  variables. 

When  the  state  machine  is  executed,  it  reads  one  data  object  from  each  of 
the  input  streams.  The  output  values  of  the  state  machine  depend  solely  upon  the 
current  values  of  the  input  objects  that  were  read  and  the  current  value  of  the  state 
variables.  At  most,  one  data  object  is  written  to  each  output  stream.  [Ref.  3] 

An  operator  that  is  implemented  using  a  PSDL  supported  programming  lan- 


4In  this  example,  state  variables  are  depicted  with  bold  lines.  This  is  the  convention  used  by  the 
graph  editor. 
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guage  is  referred  to  as  atomic.  In  this  case,  the  operator's  implementation  specifies 
the  programming  language  as  well  as  the  module  name  used  to  implement  the  op- 
erator. Operators  that  are  not  atomic  are  composite.  A  composite  operator  is  itself 
decomposed  into  a  network  of  operators;  communicating  through  data  streams.  This 
establishes  a  parent-child  relationship  between  operators.  The  composite  operator 
being  the  parent  and  the  operators  contained  in  the  decomposed  network  being  the 
children. 

Composite  operators  provide  for  a  hierarchical  decomposition  of  a  prototype. 
At  the  top  most  level,  the  prototype  consists  of  a  single  operator,  referred  to  as 
the  root  operator5.  Children  of  the  root  operator  can  either  be  implemented  as 
atomic  operators  or  as  composite  operators.  At  the  lowest  level,  all  operators  are 
implemented  as  atomic  operators. 

PSDL  provides  timers  as  predefined  abstract  state  machines.  A  timer  behaves 
similar  to  a  stopwatch.  A  timer  is  modeled  as  an  elapsed  time  value  and  a  run  switch. 
As  long  as  the  run  switch  is  on,  the  elapsed  time  value  is  incremented.  Timers  have 
four  operations:  start,  stop,  reset,  and  read.  Start  turns  on  the  run  switch.  Stop 
turns  off  the  run  switch.  Reset  turns  off  the  run  switch  and  sets  the  elapsed  time 
value  to  zero.  Read  returns  the  current  value  of  the  elapsed  time.  [Ref.  3] 

Timers  are  declared  in  the  implementation  section  of  a  composite  operator. 
Timers  differ  from  operators  in  that  they  do  not  appear  in  the  data  flow  diagram. 
Timer  values  (i.e,  the  result  of  a  read  operator)  are  accessed  by  referring  to  the  timer 
by  name  within  the  control  constraints  of  an  operator.  PSDL  semantics  provide  for 
the  insertion  of  a  timer  value  into  a  data  stream  [Ref.  3] .  Currently,  this  feature  is 
not  supported  in  the  CAPS  tools.  The  prototype  designer  should  limit  the  use  of 
timers  to  operator  constraints. 


'The  PSDL  Editor  only  supports  the  root  operator  being  implemented  as  a  composite  operator. 
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3.        Abstract  Data  Types 

The  abstract  data  type  component  introduces  a  new  type  name  for  a  user 
defined  type.  An  abstract  data  type  defines  a  set  of  values  and  a  set  of  operations 
on  that  value  set  [Ref.  11].  User  defined  data  types  are  provided  in  addition  to 
the  set  of  predefined  data  types:  boolean,  character,  string,  integer,  real,  and 
exception.  All  PSDL  abstract  data  types  are  immutable.  An  immutable  type  has  a 
fixed  set  of  values  and  the  properties  of  an  instance  of  a  type  cannot  be  changed  [Ref. 
11].  PSDL  has  no  mutable  types  or  global  variables6  in  order  to  prevent  coupling 
problems  between  operators  [Ref.  3]. 

The  set  of  operations  defined  by  an  abstract  data  type  component  are  im- 
plemented as  PSDL  operators.  Similar  to  operators  defined  by  an  abstract  state 
machine  component,  an  operator  defined  in  an  abstract  data  type  component  can 
be  implemented  either  in  a  PSDL  supported  programming  language  or  as  a  PSDL 
augmented  data  flow  diagram.  Since  an  immutable  type  has  no  memory  (i.e.,  no  state 
variables)  [Ref.  11],  it  is  a  good  design  principle  to  limit  abstract  data  type  operators 
to  functions  and  avoid  state  machines  and  timers. 

Data  streams  carry  objects  of  an  abstract  data  type,  the  data  stream  type 
being  assigned  in  a  PSDL  type  declaration  construct.  Abstract  data  type  operators 
can  appear  within  a  data  flow  diagram  as  an  operator  by  providing  the  type  name 
and  the  operator  name  separated  by  a  '.'  (e.g.,  stack. push  where  stack  is  the  type 
name  and  push  is  the  operator  name). 

Unusual  behavior  of  an  operator  can  be  flagged  through  the  use  of  an  ex- 
ception. PSDL  facilitates  this  through  the  use  of  the  built-in  abstract  data  type  of 
exception.  Exceptions  are  identified  by  name.  PSDL  provides  for  the  raising  of  an 
exception  of  a  given  name,  detecting  the  presence  of  an  exception  with  a  given  name, 


6The  PSDL  semantics  specify  that  all  streams  are  local.  However,  as  currently  implemented  in 
CAPS  Release  1,  streams  are  global,  based  on  the  stream  name.  Thus,  to  be  consistent  with  PSDL 
semantics,  streams  that  are  not  local  should  have  unique  names.  This  is  a  concession  made  in  the 
design  of  the  prototype  to  work  around  a  limitation  in  the  CAPS  tool  set  implementation. 
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and  determining  if  no  exception  was  raised  (i.e.,  normal). 

The  PSDL  syntax  provides  for  a  time  literal  (reference  production  rule  36  of 
Appendix  A)  which  consists  of  an  integer  and  an  associated  time  unit  (i.e.,  microsec- 
onds, milliseconds,  seconds,  minutes,  or  hours).  CAPS  Release  1  does  not  support 
any  time  resolution  less  than  one  millisecond.  Thus,  the  CAPS  Execution  Support 
subsystem  converts  all  time  literals  to  a  natural  number  of  milliseconds.  Any  time 
literal  less  than  a  millisecond  is  converted  to  one  millisecond.  The  PSDL  does  not 
provide  a  predefined  abstract  data  type  which  can  be  used  to  support  time  literals. 

B.      DATA  FLOW  DIAGRAM 

At  the  top  level,  a  prototype  consists  of  an  operator,  whose  implementation 
is  provided  by  an  augmented  data  flow  diagram.  After  the  initial  operator  (i.e.,  the 
prototype  level),  the  designer  may  choose  to  implement  the  behavior  of  an  operator 
with  a  network  of  simpler  operators  or  with  an  atomic  operator.  This  process  of 
decomposing  complex  operators  into  simpler  composite  operators  is  continued  until 
all  remaining  operators  are  atomic.  The  resulting  structure  is  a  hierarchical  tree, 
in  which  the  root  is  the  prototype  operator,  all  internal  nodes  are  implemented  as 
composite  operators,  and  all  leaf  nodes  are  implemented  as  atomic  operators. 

An  augmented  data  flow  diagram  consists  of  a  data  flow  diagram  depicting  a 
network  of  operators  (communicating  through  data  streams)  as  well  as  control  and 
timing  constraints  on  the  network.  A  sample  prototype  is  depicted  in  Figure  10,  in 
which  two  data  flow  diagrams  are  included.  The  root  operator  is  implemented  as  a 
composite  operator,  and  hence  has  an  associated  data  flow  diagram.  The  operator  b 
is  also  a  composite  operator  and  contains  an  associated  data  flow  diagram. 

A  data  flow  diagram  can  accept  inputs  from  an  external  producer  and  produce 
outputs  which  are  used  by  an  external  consumer.  The  inputs  and  outputs  of  a  com- 
posite operator  are  declared  in  the  composite  operator's  specification  section.  These 
inputs  and  outputs  correspond  to  the  inputs  and  outputs  depicted  in  the  parent  data 
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Figure  11.  Operator  Precedence  Relationship 

flow  diagram.  This  can  be  seen  in  Figure  10.  Within  the  operator  b  component, 
the  specification  declares  x  to  be  an  input  and  y  to  be  an  output.  These  inputs  and 
outputs  correspond  to  the  streams  into  and  out  of  the  subject  operator  (i.e.,  b)  de- 
picted in  the  parent  data  flow  diagram  (i.e.,  the  root  operator).  The  root  operator 
corresponds  to  a  closed  system,  in  which  there  are  no  external  inputs  or  outputs. 

While  the  PSDL  syntax  supports  a  textual  description  of  the  augmented  data 
flow  diagram,  the  PSDL  Editor  provides  a  graphical  interface  to  the  user  for  creating, 
maintaining  and  browsing  the  data  flow  diagram.  Within  the  graphical  interface,  an 
operator  is  represented  as  a  bubble  and  a  data  stream  is  represented  as  a  directed 
line  segment  from  the  producer  operator  to  the  consumer  operator. 

A  precedence  relationship  establishes  a  partial  ordering  of  the  execution  sched- 
ule based  on  the  data  stream  paths  between  operators.  Figure  11  depicts  two  opera- 
tors, A  and  B,  which  share  a  data  stream,  X.  The  execution  of  B  requires  the  availability 
of  data  from  X.  Hence,  operator  A  must  be  executed  prior  to  the  execution  of  operator 
B. 

Figure  12  depicts  the  same  state  machine  with  a  feedback  loop  added,  data 
stream  FB.  In  this  situation,  each  operator  depends  on  the  output  of  the  other  oper- 
ator. CAPS  requires  that  every  cycle  within  a  data  flow  diagram  be  broken  with  a 
state  stream.  That  is,  one  of  the  data  streams  on  the  cycle  must  be  designated  a  state 
stream  and  provided  with  an  initial  value.  The  initial  value  of  the  state  stream  breaks 
the  circular  precedence  relationship  that  would  otherwise  be  impossible  to  schedule. 
In  order  to  obtain  a  valid  PSDL  prototype,  the  designer  must  ensure  that  the  data 
streams  (excluding  state  streams)  of  every  data  flow  diagram  form  a  directed  acyclic 
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Figure  12.  Cyclic  Precedence  Relationship 


Figure  13.  Data  Flow  Diagram  Loop 

graph  (DAG).  Each  cycle  which  is  found  in  the  data  streams  of  a  data  flow  diagram 
must  be  broken,  either  by  the  removal  of  a  data  stream  or  by  designating  one  of  the 
data  streams  to  be  a  state  stream.  This  rule  applies  to  simple  loops  as  depicted  in 
Figure  13. 

1.        Operators 

In  support  of  real-time  prototypes,  PSDL  provides  both  time  critical  and  non- 
time  critical  operators  (reference  the  taxonomy  of  an  operator  depicted  in  Figure  8). 
Execution  of  time  critical  operators  can  be  triggered  either  periodically  or  sporadically 
(i.e.,  data  driven). 

In  order  for  the  CAPS  Execution  Support  subsystem  to  obtain  a  schedule 
which  executes  each  operator  consistently  with  the  timing  constraints  of  the  aug- 
mented data  flow  diagram,  a  bound  must  be  placed  on  the  execution  time  of  the 
operators.  This  bound  is  referred  to  as  the  maximum  execution  time  (MET).  An 
operator  is  time  critical  if  and  only  if  it  has  been  assigned  an  MET.  Otherwise,  the 
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operator  is  non-time  critical.  [Ref.  3] 

A  time  critical  operator  is  triggered  periodically  if  it  contains  a  period  (P) 
timing  constraint.  Otherwise,  the  operator  is  triggered  sporadically,  based  on  the 
arrival  of  data  (i.e.,  data  driven),  and  must  contain  a  data  trigger  control  constraint. 

Since  a  PSDL  prototype  represents  a  closed  system,  often  it  is  necessary  to 
include  operators  which  are  not  considered  to  be  part  of  the  prototype  to  create  the 
closed  system.  PSDL  facilitates  the  inclusion  of  these  external  systems  as  terminators. 
Terminators  are  operators  with  an  assigned  MET  of  zero7,  and  thus  the  time  required 
to  execute  the  terminator  is  not  counted  against  the  prototype  execution  time.  The 
CAPS  maintains  a  simulated  real-time  clock.  During  the  execution  of  a  terminator, 
the  simulated  real-time  clock  is  turned  off.  Terminators  are  represented  in  the  PSDL 
Editor  by  a  rectangular  bubble  within  the  data  flow  diagram.  Operators  with  a  non- 
zero MET  (including  those  operators  with  an  undefined  MET)  are  represented  in  the 
PSDL  Editor  by  a  circular  bubble. 

2.       Streams 

Streams  are  used  to  communicate  data  objects  of  a  fixed  data  type  from  a 
set  of  one  or  more  producer  operators  to  a  set  of  one  or  more  consumer  operators 
[Ref.  9]8.  While  the  PSDL  syntax  and  the  PSDL  Editor  represent  a  stream  as  a  link 
from  one  producer  to  one  consumer,  multiple  producers  and  multiple  consumers  are 
supported  by  matching  stream  names  (i.e.,  identifiers)  within  the  stream  scope. 

PSDL  provides  two  types  of  data  streams:  data  flow  streams  and  sampled 
streams.  A  data  flow  stream  guarantees  that  no  data  object  is  lost  or  replicated.  The 
data  flow  stream  behaves  like  a  first-in-first-out  (FIFO)  queue  with  a  length  of  one  for 
each  consumer.  A  sampled  stream  behaves  like  a  single  memory  cell  which  contains 
one  data  object  for  each  consumer.  The  most  recent  data  value  is  obtained  each  time 


7 Since  all  terminators  have  an  MET  of  zero,  they  are  considered  time  critical  and  are  placed  on 
the  static  schedule. 

8This  implementation  is  a  change  from  that  presented  in  [Ref.  3]. 
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the  stream  is  read.  Thus,  data  objects  may  be  lost  if  associated  with  a  fast  producer 
or  replicated  if  associated  with  a  slow  producer.  The  type  of  data  stream  used  is 
determined  by  the  consuming  operator's  trigger  control  constraint.  If  the  consuming 
operator  contains  a  triggered  by  all  control  constraint  for  a  set  of  streams,  those 
streams  are  data  flow  streams.  Otherwise,  the  stream  is  a  sampled  stream. 

The  FIFO  queue  length  of  one  for  a  data  flow  stream  restricts  the  relative 
execution  rates  between  the  producer  and  consumer  operators.  In  order  to  guarantee 
that  no  data  object  is  lost  or  replicated,  the  output  rate  of  the  producer  must  not  ex- 
ceed the  execution  rate  of  the  consumer  for  all  data  flow  streams.  No  such  restriction 
is  placed  on  a  sampled  stream. 

3.       State  Streams 

State  streams  provide  a  state  machine  with  memory.  State  streams  are  also 
used  to  schedule  data  flow  diagrams  that  would  otherwise  be  impossible  to  schedule 
due  to  circular  precedence  constraints.  A  state  stream  is  declared  in  the  specification 
section  of  the  component  in  which  the  state  stream  first  appears  in  the  data  flow 
diagram.  In  Figure  10,  the  state  stream  s  first  appears  in  the  data  flow  diagram  of 
operator  b.  The  state  stream  declaration  appears  in  the  specification  of  operator  b  as 
well.  Within  the  components  of  operators  e  and  d,  the  producer  and  consumer  of  s 
respectively,  s  only  appears  within  the  specification's  output  and  input  declarations. 

A  state  stream  differs  from  a  data  stream  in  that  a  state  stream  must  include 
an  initial  value.  It  is  the  initial  value  of  a  state  stream  which  makes  it  possible  for  a 
state  stream  to  break  a  circular  precedence  constraint.  A  state  stream  is  also  required 
when  connecting  time  critical  and  non-time  critical  operators  [Ref.  9]. 

Note  that,  under  CAPS  Release  1,  all  state  streams  are  implemented  as  sam- 
pled streams  regardless  of  the  trigger  constraint.  Data  flow  state  streams  are  not 
provided. 
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Table  I.  PSDL  Constraints 


Constraint 


MET 

Period 

Finish  Within 

MRT 

MCP 

Data  Trigger 

Conditional  Exec 

Output  Guard 

Exceptions 

Timers 


Operator 


Non-Time  Critical 


Undefined 


Optional 
Optional 
Optional 
Optional 
Optional 


Time  Critical 


Periodic 


Required 

Required 

default:  Period 


Optional 
Optional 
Optional 
Optional 
Optional 


Sporadic 


Required 


Required0 
default:  MRT-MET 
Required 
Optional 
Optional 
Optional 
Optional 


Constraint 

Operator 

Constraint 

Stream 

Terminator 

Operator 

Data  Flow 

Sampled 

MET 

0 

Otherwise 

Data  Trigger 

by  all" 

Otherwise 

aIf  MCP  is  set  instead,  MRT  defaults  to  MCP+MET. 

6Under  CAPS  Release  1,  all  state  streams  are  implemented  as  Sampled  Streams. 


4.       Constraints 

Constraints  augment  the  data  flow  diagram  in  order  to  control  the  execution 
of  operators,  generation  of  output,  processing  of  exceptions,  and  timers.  Constraints 
also  determine  the  implementation  of  data  streams.  Table  I  lists  the  constraints 
required  to  obtain  a  specified  functionality  of  operators  and  streams  as  well  as  those 
constraints  which  are  optional. 

Execution  guards  provide  for  the  conditional  execution  of  an  operator.  Exe- 
cution guards  are  provided  by  the  constructs: 

operator  (op.id)  [  triggered  by  all  (idJist)  ]  [  if  (expression)  ] 
operator  (opJd)  [  triggered  by  some  (idJist)  ]  [  if  (expression)  } 

Only  one  of  the  above  constructs  is  permitted  for  each  operator  of  a  data  flow  diagram. 
Each  construct  has  two  conditions,  a  data  trigger  condition  and  an  if  condition.  The 
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two  conditions  can  be  used  independently  or  together  to  provide  an  execution  guard 
on  the  operator. 

The  data  trigger  condition  triggered  by  all  is  satisfied  only  if  all  of  the 
streams  listed  in  the  (idJist)  have  new  data  objects  (i.e.,  has  been  written  to  since 
the  last  read  operation).  The  data  trigger  condition  triggered  by  some  is  satisfied  if 
at  least  one  of  the  streams  listed  in  the  (idJist)  has  a  new  data  object.  A  data  trigger 
condition  is  required  for  a  sporadic  operator.  It  is  an  optional  execution  guard  for 
periodic  and  non-time  critical  operators.  As  can  be  seen  in  Table  I,  the  triggered 
by  all  condition  is  also  used  to  designate  a  stream  as  a  data  flow  stream  for  the 
consuming  operator. 

The  second  condition  within  the  execution  guard  is  the  if  condition.  Identifiers 
of  the  conditional  (expression)  are  limited  to  those  of  input  streams  as  well  as  those 
of  visible  timers  and  exceptions. 

Output  guards  provide  for  the  conditional  transmission  of  an  operator's  output 
stream.  The  operator's  result  is  not  transmitted  over  the  stream  unless  the  output 
guard  expression  is  satisfied.  One  output  guard  is  permitted  for  each  of  the  operator's 
output  streams.  Identifiers  of  the  output  guard  expression  are  limited  to  those  of  the 
operator's  input  and  output  streams  as  well  as  those  of  visible  timers  and  exceptions. 

Exception  guards  provide  for  the  conditional  raising  of  an  exception.  Multiple 
exception  guards  are  permitted,  one  for  each  exception  to  be  raised.  The  resulting 
exception  is  transmitted  on  all  output  streams  of  type  exception  leaving  the  operator, 
subject  to  any  output  guard  constraints  defined  for  those  streams.  Identifiers  of  the 
exception  guard  conditional  expression  are  limited  to  those  of  the  operator's  input 
and  output  streams  as  well  as  those  of  visible  timers  and  exceptions.  If  the  exception 
guard  conditional  expression  is  missing,  it  is  assumed  to  be  true. 

Timer  control  constraints  provide  for  the  conditional  control  of  a  timer.  Con- 
ditional control  is  provided  to  start,  stop,  and  reset  a  timer.  Identifiers  of  the  timer 
control  conditional  expression  are  limited  to  those  of  the  operator's  input  and  out- 
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Table  II.  PSDL  Timing  Constraints;  From  [Ref.  6] 


Periodic  Operator 

Sporadic  Operator 

Maximum  Execution  Time  (MET) 

Period  (P) 

Finish  Within  (FW) 

Maximum  Execution  Time  (MET) 
Minimum  Calling  Period  (MCP) 
Maximum  Response  Time  (MRT) 

put  streams  as  well  as  those  of  visible  timers  and  exceptions.    If  the  timer  control 
conditional  expression  is  missing,  it  is  assumed  to  be  true. 

There  are  five9  timing  constraint  parameters  used  for  a  PSDL  operator.  These 
parameters  are  listed  in  Table  II,  under  the  class  of  time  critical  operators  where  they 
are  used,  and  are  defined  as  follows  [Ref.  6]: 

Maximum  Execution  Time  (MET)  An  upper  bound  on  the  execution 
time  from  start  to  finish  of  an  operator. 

Period  (P)  The  elapsed  time  between  two  successive  triggerings  of  a  periodic 
operator  at  the  earliest  possible  moment. 

Finish  Within  (FW)  An  upper  bound  on  the  elapsed  time  that  may  pass 
between  the  earliest  time  that  a  periodic  operator  can  be  triggered  and  the 
latest  time  the  operator  must  produce  all  output  stream  values. 

Minimum  Calling  Period  (MCP)  A  lower  bound  on  the  amount  of  time 
that  may  pass  between  successive  triggerings  of  a  sporadic  operator. 

Maximum  Response  Time  (MRT)  An  upper  bound  on  the  amount  of 
time  that  may  elapse  from  the  arrival  of  data  which  triggers  an  operator 
to  the  time  that  all  output  streams  have  been  produced. 

The  absence  of  a  MET  constraint  is  used  to  indicate  that  the  operator  is  non- 
time  critical.  Otherwise,  the  operator  is  time  critical.  Only  time  critical  operators 
are  allowed  to  have  timing  constraints  [Ref.  9].  Only  the  MET  is  displayed  by  the 
PSDL  Editor  on  the  data  flow  diagram. 


'MET  appears  twice  in  Table  II,  under  both  Periodic  and  Sporadic  operators. 
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Period 


FW 


MET 


Scheduling  Interval 
Execution  Time 


Figure  14.  Periodic  Timing  Constraints;  From  [Ref.  9] 

Periodic  operators  are  scheduled  at  nearly  regular  time  intervals.  Figure  14 
depicts  the  relationship  between  the  timing  constraints  for  a  periodic  operator.  The 
MET  and  Period  (P)  must  be  assigned  for  a  periodic  operator.  If  a  FW  constraint  is 
not  specified,  it  is  defaulted  to  P. 

Jitter  is  an  upper  bound  on  the  time  that  may  elapse  between  two  successive 
executions  of  a  periodic  operator.  The  worst  case  of  jitter  is  obtained  with  the  default 
value  of  the  FW  constraint  (i.e.,  FW  =  P).  In  such  a  case,  the  jitter  is  given  by  twice 
the  difference  of  the  P  and  the  MET.  Jitter  can  be  reduced  to  zero  by  setting  the  FW 
constraint  equal  to  the  MET. 

Sporadic  operators  are  triggered  by  the  arrival  of  data.  Figure  15  depicts  the 
relationship  between  the  timing  constraints  for  a  sporadic  operator.  The  MET  must 
be  assigned  along  with  either  the  MCP  or  the  MRT  or  both. 

Limits  are  placed  on  the  values  of  MCP  and  MRT  in  the  absence  of  a  pipelined 
execution  implementation.  The  MCP  must  be  greater  than  or  equal  to  the  MET. 
The  MRT  must  be  greater  than  or  equal  to  twice  the  MET.  If  the  MRT  constraint 
is  specified  and  the  MCP  constraint  is  left  unspecified,  then  the  MCP  defaults  to  the 
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CP  >=  MCP 


MRT 


MET 


t 


data  arrives 


t 


data  arrives 


Scheduling  Interval 
Execution  Time 


CP  is  the  calling  period 

Figure  15.  Sporadic  Timing  Constraints;  From  [Ref.  9] 

difference  between  the  MRT  and  the  MET.  If  the  MCP  constraint  is  specified  and  not 
the  MRT  constraint,  then  the  MRT  defaults  to  the  sum  of  the  MCP  and  the  MET. 
One  additional  timing  constraint  is  provided  for  streams.  Latency  is  the  lower 
bound  on  the  elapsed  time  from  when  data  is  written  to  a  stream  by  the  producer 
until  the  time  that  the  data  can  be  read  from  the  stream  by  the  consumer.  Latency 
is  also  displayed  by  the  PSDL  Editor  in  the  data  flow  diagram. 

C.      HIERARCHICAL  NETWORK 

A  PSDL  prototype  is  built  of  PSDL  operators,  implemented  as  either  data 
flow  diagrams  or  with  a  PSDL  supported  programming  language,  in  a  hierarchical 
manner.  The  root  operator  is  at  the  top  of  the  hierarchy,  which  is  always  implemented 
as  a  data  flow  diagram.  Each  of  the  operators  referenced  in  the  data  flow  diagram 
is  also  specified  as  a  PSDL  component  (either  as  an  abstract  state  machine  or  as  an 
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operator  of  an  abstract  data  type). 

The  specification  of  each  operator  establishes  the  interface  to  the  operator 
while  the  details  are  hidden  in  the  implementation.  For  a  given  operator,  the  inputs 
and  outputs  declared  in  the  specification  correlate  to  the  input  and  output  streams 
of  the  corresponding  operator  of  the  parent's  data  flow  diagram.  States  depicted  in 
the  data  flow  diagram  found  in  an  operator's  implementation  are  also  declared  in 
that  operator's  specification.  Exceptions  processed  in  an  operator's  implementation 
are  also  declared  in  that  operator's  specification.  Timers  processed  in  an  operator's 
implementation  are  declared  in  that  operator's  implementation.  The  declaration  of 
input  and  output  streams,  state  streams,  and  exceptions  is  provided  for  with  the 
automatic  PSDL  code  generation  of  the  PSDL  Editor.  However,  the  PSDL  Editor 
has  no  provisions  for  the  automatic  generation  of  the  timer  declaration.  It  is  the 
responsibility  of  the  user  to  properly  declare  all  timers. 

The  use  of  a  hierarchical  structure  comes  with  additional  semantic  require- 
ments. 

1.       Root  Operator 

A  PSDL  prototype  contains  a  single  root  operator.  Any  operator  that  is  not  in 
a  hierarchical  decomposition  of  the  root  operator  is  considered  to  be  a  multiple  root 
operator  and  represents  an  error.  Use  of  the  PSDL  Editor  ensures  that  a  multiple  root 
operator  error  can  not  occur.  A  single  root  operator  is  provided  by  the  PSDL  Editor 
upon  entry.  All  subsequent  operators  are  introduced  as  decompositional  operators 
within  a  hierarchy.  Within  the  PSDL  Editor,  if  a  composite  operator  is  deleted,  the 
child  operators  will  be  deleted. 

CAPS  follows  the  convention  that  the  name10  of  the  root  operator  is  the  same 
as  that  of  the  file  name  that  contains  the  prototype.  The  extension  ".psdl"  is  added 


10In  order  for  CAPS  to  provide  for  duplicate  operator  names  in  different  scopes,  the  PSDL  Editor 
appends  an  operator  identification  number  to  the  operator  name.  This  identification  number  is  not 
included  in  the  PSDL  prototype  file  name. 
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to  the  file  name. 

While  not  limited  in  the  PSDL  syntax,  the  PSDL  Editor  limits  the  root  op- 
erator to  one  which  corresponds  to  a  closed  system.  There  are  no  inputs  to,  or 
outputs  from,  the  root  operator.  If  inputs  and/or  outputs  are  required,  the  scope 
of  the  prototype  should  be  expanded  so  that  the  required  inputs  and/or  outputs  are 
contained  within  the  prototype11.  The  only  (attributes)  (reference  production  rule  8 
in  Appendix  A)  permitted  within  the  specification  of  the  root  operator  are  generic, 
states,  and  exceptions. 

In  addition,  the  PSDL  Editor  limits  the  root  operator  of  the  prototype  to 
a  PSDL  implementation.  No  provisions  are  made  in  the  PSDL  Editor  for  a  root 
operator  implemented  in  a  programming  language. 

2.        Stream  Consistency 

Within  the  hierarchical  structure  of  PSDL,  a  composite  operator  is  imple- 
mented as  a  data  flow  diagram  of  a  PSDL  component  at  a  lower  level.  All  inputs  to 
the  composite  operator  must  be  utilized  as  an  external  input  to  at  least  one  of  the 
operators  in  the  decomposed  data  flow  diagram.  Likewise,  all  outputs  of  the  compos- 
ite operator  must  be  utilized  as  an  external  output  from  at  least  one  of  the  operators 
in  the  decomposed  data  flow  diagram.  A  similar  set  of  rules  require  that  all  external 
inputs  to  a  decomposed  data  flow  diagram  must  be  inputs  to  the  composite  operator 
and  all  external  outputs  to  a  decomposed  data  flow  diagram  must  be  outputs  from 
the  composite  operator.  [Ref.  3] 

External  streams  in  a  decomposed  data  flow  diagram  inherit  the  stream's  data 
object  type  of  the  the  composite  operator.  In  addition,  which  type  of  stream  (i.e., 
data  flow  stream  or  sample  stream)  is  derived  from  the  trigger  constraint  of  the 


11  User  provided  inputs  as  well  as  output  displays  to  the  user  are  typically  handled  by  an  operator 
(or  terminator)  contained  within  the  prototype.  Such  an  input/output  operator  may  be  imple- 
mented in  TAE.  While  user  input  and/or  output  may  be  considered  external,  the  use  of  an  operator 
(terminator)  to  capture  the  requirements  and  specification  of  the  input  and/or  output  is  considered 
to  "close"  the  prototype  system. 
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consuming  operator.  For  a  composite  operator,  as  explained  above,  an  input  to  a 
composite  operator  must  also  be  an  input  to  at  least  one  operator  in  the  decomposed 
data  flow  diagram.  The  trigger  constraints  of  both  the  composite  operator  and  those 
of  the  applicable  decomposed  operators  are  used  in  the  derivation  of  the  type.  [Ref. 

3] 

3.  Timing 

The  MET  and  the  MRT  of  a  composite  operator  must  be  consistent  with  the 
implementation  of  the  operator  as  a  data  flow  diagram.  The  MET  and  the  MRT  of 
the  implementing  data  flow  diagram  must  be  no  larger  than  that  of  the  composite 
operator.  The  Period  and  the  MCP  of  a  composite  operator  are  inherited  be  the  the 
operators  of  the  implementing  data  flow  diagram. 

4.  Visibility 

The  CAPS  semantics  requires  that  operator  names  within  a  composite  opera- 
tor are  to  be  local  to  the  component.  In  order  to  accomplish  this,  the  PSDL  Editor 
supports  integer  suffixes  which  are  attached  to  the  operator  name  (reference  memo 
provided  in  Appendix  C).  This  feature  will  not  be  available  until  CAPS  Release  2. 

The  CAPS  semantics  provides  for  all  streams  to  be  local.  Streams  with  an 
identical  name  out  of  a  common  operator  are  local.  Streams  with  identical  names,  but 
out  of  different  operators  are  not  local.  However,  as  implemented  in  CAPS  Release 
1,  streams  are  global.  That  is,  any  two  streams  with  a  common  name  are  visible.  In 
order  to  maintain  the  PSDL  semantics,  all  streams  that  are  not  desired  to  be  local 
should  have  unique  names.  This  is  a  concession  made  in  the  prototype  design  to 
workaround  an  implementation  limitation  of  CAPS  Release  1. 

When  an  exception  is  raised  by  an  operator,  the  exception  is  transmitted  on 
all  data  streams  of  type  exception,  regardless  of  the  exception  stream  label,  leaving 
the  operator,  subject  to  the  stream  output  guard.  The  exception  is  transmitted  only 
over  local  exception  streams.  Thus  the  exception  is  not  transmitted  over  exception 
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streams  which  are  outputs  of  another  operator.  At  least  one  exception  output  stream 
should  be  provided  for  each  operator  which  is  capable  of  generating  an  exception. 
[Ref.  9] 

A  timer  is  visible  within  the  component  in  which  it  is  declared.  If  the  com- 
ponent's data  flow  diagram  contains  a  composite  operator,  then  the  timer  is  visible 
within  the  decomposed  components. 

D.      LEXICAL  ELEMENTS 

Each  PSDL  component  is  composed  of  a  sequence  of  lexical  elements.  Lexical 
elements  are  in  turn  composed  of  characters.  A  lexical  element  is  either  an  integer 
literal,  a  real  literal,  a  string  literal,  text,  an  identifier  (including  keywords),  or  a 
delimiter12. 

When  a  prototype  is  maintained  by  the  PSDL  Editor,  the  editor  will  ensure 
that  the  prototype  is  syntactically  correct.  User  input  provided  through  the  PSDL 
Editor's  graphical  interface  are  validated  as  required  and  are  automatically  translated 
into  a  syntactically  correct  PSDL  prototype.  Thus  many  of  the  rules  presented  in 
this  section  do  not  impact  the  prototype  developer  since  they  are  maintained  by  the 
PSDL  Editor.  If  a  developer  chooses  to  maintain  a  prototype  using  any  other  system, 
it  is  the  responsibility  of  the  developer  to  adhere  to  the  syntax  of  PSDL.  Very  little 
assistance  in  the  form  of  error  messages  is  provided  to  the  developer  who  introduces 
syntactical  errors  into  a  prototype.  In  most  cases,  the  PSDL  Editor  will  not  be  able 
to  recover  from  these  syntax  errors. 

1.       Character  Set 

The  PSDL  character  set  is  composed  of  the  95  printable  ASCII  characters 
from  ASCII  V  (space)  through  ASCII  '"'  (tilde)  plus  the  line  feed  (ASCII  character 
10)  and  horizontal  tab  (ASCII  character  9)  characters. 


12The  time  literal  mentioned  earlier  is  not  truly  a  literal.  Rather,  it  is  a  grammatical  rule  which 
combines  an  integer  literal  with  a  keyword  representing  the  time  units. 
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Right  brace,  '}',  is  a  special  character  in  that  it  is  included  in  the  PSDL  syntax, 
however,  it  is  not  allowed  to  appear  anywhere  except  the  closing  of  a  description  or 
an  axioms  structure  (reference  production  rule  45  of  Appendix  A  for  the  definition 
of  a  character  and  production  rules  15  and  16  for  the  use  of  '}').  The  format  effectors 
vertical  tab,  carriage  return,  and  form  feed  can  not  appear  anywhere  other  than  the 
(text)  field  of  the  description  or  the  axioms  structures13. 

2.  Integer  Literals 

An  integer  literal  (reference  production  rule  43  of  Appendix  A)  is  an  unsigned 
number.  All  integer  literals  are  base  ten  and  do  not  contain  any  character  other  than 
the  digits  0  through  9.14 

3.  Real  Literals 

A  real  literal  (reference  production  rule  42  of  Appendix  A)  is  an  unsigned  real 
number.  All  real  literals  are  base  ten.  A  real  number  must  contain  a  decimal  value 
(which  may  be  0),  a  decimal  point  ('.'),  and  a  fractional  value  (which  may  also  be 
0).  Exponential  notation  is  not  allowed. 

4.  String  Literals 

A  string  literal  (reference  production  rule  44  of  Appendix  A)  is  any  number 
of  characters  from  the  PSDL  character  set,  delimited  by  quotations  ("").  There 
are  four  characters  that  are  not  allowed  within  a  string  literal:  the  quotation  mark 
(""),  the  right  brace  character  ('}'),  and  the  format  effectors  horizontal  tab  and  line 
feed.  PSDL  does  not  specify  any  limit  on  string  literal  length.  The  empty  string  is 
represented  as  """.  Strings  are  case  sensitive. 


13The  use  of  these  characters  is  not  recommended. 

14Within  the  PSDL  Editor,  integer  literals  are  represented  by  a  C  integer  data  type.  In  the 
current  implementation,  this  is  a  32  bit  value.  Only  the  non-negative  values  can  be  represented  as 
an  integer  literal. 
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5.  Text 

Text  (reference  production  rule  49  of  Appendix  A)  can  only  appear  within  the 
description  and  the  axioms  structures  of  PSDL.  Within  these  two  structures,  text 
is  any  number  of  characters  from  the  PSDL  character  set,  delimitated  by  braces  ('{' 
and  '}').  Hence,  the  right  brace  ('}')  can  not  appear  within  the  text.  Any  other 
character,  including  horizontal  tab  and  line  feed,  are  permitted  within  the  text.  Text 
is  the  only  lexical  element  that  is  allowed  to  cross  a  line  separator. 

6.  Identifiers 

An  identifier  (reference  production  rule  41  of  Appendix  A)  consists  of  a  letter, 
followed  by  any  number  of  letters,  digits,  or  underscore  ('_')  characters.  All  characters 
of  an  identifier  are  significant  and  are  case  sensitive.15 

7.  Reserved  Words 

While  not  addressed  in  the  specification  of  PSDL  [Ref.  3],  the  implementation 
of  the  PSDL  Editor  utilizes  reserved  words.  A  list  of  these  reserved  words  is  provided 
in  Table  III.  Reserved  words  can  not  be  used  as  identifiers  within  the  PSDL  prototype. 
Reserved  words  differ  from  identifiers  in  that  reserved  words  are  case  insensitive  (e.g., 
OPERATOR,  Operator,  and  operator  are  all  reserved  words). 

Table  IV  contains  additional  PSDL  keywords  that  do  not  match  the  syntax 
of  an  identifier  and  hence  are  not  reserved.  However,  they  are  still  tokens  within  the 
PSDL  syntax.  The  symbol  'u'  is  used  to  represent  a  single  space.  This  single  space  is 
part  of  the  keyword  and  can  not  be  altered  by  removal,  adding  of  additional  spaces, 
or  replaced  with  a  horizontal  tab. 

In  addition  to  the  above  keywords  (Tables  III  and  IV),  PSDL  defines  a  set  of 
identifiers  that  are  available  to  the  prototype  developer.    This  set  of  identifiers  and 


15The  PSDL  Editor  treats  identifiers  as  being  case  sensitive.  Note  that  Ada  identifiers  are  case 
insensitive  [Ref.  12].  Since  CAPS  generates  control  code  in  Ada  it  is  not  advisable  to  name  two 
identifiers  that  only  differ  in  case.  Moreover,  the  CAPS  Release  2  PSDL  Editor  will  convert  all 
characters  of  the  identifiers  to  lower-case. 
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Table  III.  PSDL  Reserved  Words 


abs 

all 

and 

axioms 

boolean 

description 

edge 

end 

exception 

exceptions 

external 


false 

generic 

graph 

hours 

if 

implementation 

initially 

input 

integer 

keywords 

microsec 


mm 

mod 

ms 

not 

operator 

or 

output 

period 

property 

real 

rem 


sec 

some 

specification 

states 

timer 

triggered 

true 

type 

vertex 

xor 


Table  IV.  Additional  PSDL  Keywords 


controluconstraints 
dataustream 
finishu  within 
maximumuexecutionutime 


maximumuresponseutime  startutimer 

minimumucallinguperiod  stoputimer 

requireduby  triggereduby 
resetutimer 


their  application  are  provided  in  Table  V. 

Table  VI  contains  additional  identifiers  that  are  denned  by  the  PSDL  Edi- 
tor for  the  purpose  of  describing  the  data  flow  graph.  These  identifiers  appear  in 
PROPERTY  constructs  of  the  PSDL  syntax  (reference  production  rules  20  -  23  in 
Appendix  A).  The  attributes  of  the  data  flow  diagram  that  are  controlled  by  these 

Table  V.  Predefined  PSDL  Identifiers 

Identifier  Application 

ADA  Implementation  Language 

TAE  Implementation  Language 

other  Place  holder  for  other  implementation  languages 

normal  Exception 

character  Predefined  data  type 

string  Predefined  data  type 
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Table  VI.  PSDL  Editor  Identifiers 


Identifier 


Application 


color 

is_terminator 
label -font 
label_x_off  set 
label_y_offset 
latency.f ont 
latency_x_off  set 
latency_y_off set 
met  _font 
met_x_off  set 
met_y_off  set 
radius 
spline 
x 

y 


Integer  representing  color  of  Operator 

TRUE  if  Operator  is  a  Terminator 

Integer  representing  font  of  Label 

Signed  integer  representing  relative  y  position  of  Label 

Signed  integer  representing  relative  x  position  of  Label 

Integer  representing  font  of  Latency 

Signed  integer  representing  relative  y  position  of  Latency 

Signed  integer  representing  relative  x  position  of  Latency 

Integer  representing  font  of  MET 

Signed  integer  representing  relative  y  position  of  MET 

Signed  integer  representing  relative  x  position  of  MET 

Integer  representing  radius  of  Operator 

List  of  absolute  x,  y  positions  of  Splines 

Absolute  x  location  of  Operator 

Absolute  y  location  of  Operator 


identifiers  are  maintained  by  the  PSDL  Editor  and  are  hidden  from  the  user  by  the 
PSDL  Editor.  They  will  be  visible  in  the  PSDL  prototype  code  generated  by  the 
PSDL  Editor. 

8.  Delimiters 

Delimiters  are  required  to  separate  adjacent  lexical  elements.  Delimiters  in- 
clude a  space  character  (except  when  included  in  a  string  literal  or  text),  a  line  feed, 
or  one  of  the  symbols  listed  in  Table  VII. 

9.  Comments 

The  PSDL  syntax  does  not  provide  for  comments  in  the  sense  of  comments 
provided  by  languages  such  as  Ada.  Provisions  are  made  for  structured  documenta- 
tion of  the  prototype.  The  format  and  placement  of  these  structures  is  defined  by  the 
PSDL  syntax  (reference  Appendix  A).  The  reserved  words  description,  axioms, 
keywords,  and  required  by  are  tokens  used  to  introduce  documentation  into  the 
prototype. 
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Table  VII.  PSDL  Delimiters 

&  ,     ~T~  T 
(  <     1 

)  ->   <=   { 

*  .  = 

**  /  >  } 

+  /=      >= 


Note  that,  while  description  and  axioms  constructs  facilitate  the  textual 
documentation  of  the  prototype,  keywords  and  required  by  constructs  are  re- 
stricted to  an  (iddist). 

E.       PSDL  EXECUTION 

CAPS  provides  facilities  for  executing  a  PSDL  prototype  when  supported  with 
software  components  written  in  an  underlying  programming  language  (e.g.,  Ada)  [Ref. 
3].  These  software  components  may  be. obtained  from  a  software  base  of  reusable 
components  or  supplied  by  the  prototype  developer. 

An  executable  prototype  is  generated  in  three  steps,  available  through  the 
Executive  Support  subsystem  of  CAPS.  Figure  16  depicts  the  CAPS  Release  1  user 
interface  access  to  these  steps16.  The  first  two  steps  (i.e.,  Translate  and  Schedule)  are 
used  to  generate  the  "supervisory"  module  which  provides  for  control  and  commu- 
nication within  the  prototype.  When  Compile  is  invoked,  the  "supervisory"  module 
along  with  the  packages  used  to  implement  the  atomic  operators  and  data  types  are 
compiled.  The  prototype  is  run  by  invoking  Execute. 

Translation  actually  involves  two  processes.  The  first  process  involves  flat- 
tening the  hierarchical  structure  of  data  flow  diagrams  in  an  expansion  process.  The 


16Note  that  this  version  of  the  PSDL  Editor  is  in  support  of  the  PSDL  grammar  which  will 
be  integrated  with  CAPS  Release  2.  This  PSDL  Editor  is  not  compatible  with  CAPS  Release  1. 
Comments  on  compatibility  can  be  found  in  Appendix  B.  Execution  of  a  PSDL  prototype  under 
CAPS  Release  1  is  covered  here  since  it  is  likely  that  the  same  steps  will  still  be  required  with  CAPS 
Release  2. 
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Figure  16.  CAPS  Release  1  Executive  Support 

second  process  is  to  generate  the  Ada  code  required  to  support  the  timers,  exceptions, 
stream  communication,  and  control  constraints. 

The  remainder  of  the  "supervisory"  module  is  generated  by  the  scheduler.  The 
scheduler  creates  a  high  priority  Ada  task  to  control  the  static  schedule  (i.e.,  time 
critical  operators)  and  a  lower  priority  Ada  task  to  control  the  dynamic  schedule  (i.e., 
non-time  critical  operators). 

All  of  the  generated  "supervisory"  code  is  gathered  together  in  one  file  which 
is  named  after  the  prototype  name  with  an  ".a"  extension.  Which,  assuming  that 
the  prototype  was  successfully  translated  and  scheduled,  is  compiled  with  the  atomic 
operators  and  data  types.  The  result  is  an  executable  prototype. 
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III.         PSDL  SYNTAX/SEMANTIC 
CONSIDERATIONS 

The  PSDL  Editor  is  a  language  sensitive  editor  with  embedded  knowledge 
of  PSDL  syntax  and  semantics.  The  PSDL  Editor  assists  the  user  by  ensuring  a 
syntactically  correct  prototype,  with  limited  automatic  PSDL  code  generation  and 
limited  semantic  consistency  checking.  In  the  CAPS  Release  1  PSDL  Editor,  this 
was  primarily  accomplished  by  the  syntax-directed  editor  produced  by  the  Synthe- 
sizer Generator.  The  graph  editor  served  two  purposes.  First,  the  graph  editor  was 
used  to  present  the  data  flow  diagram  corresponding  to  the  operator  selected  in  the 
syntax-directed  editor.  Second,  the  graph  editor  was  used  to  create/maintain  the 
data  flow  diagram  of  an  operator  selected  in  the  syntax-directed  editor.  Since  only 
the  structure,  labels,  and  a  few  timing  parameters  of  the  data  flow  diagram  could  be 
displayed/entered  in  the  graph  editor,  a  simple  interface  was  all  that  was  required  to 
integrate  the  two  segments  of  the  PSDL  Editor. 

In  an  attempt  to  meet  the  goal  of  minimizing  the  artificial  boundary  produced 
by  implementing  the  PSDL  Editor  with  both  a  syntax-directed  editor  and  a  graph 
editor,  as  well  as  overcoming  the  linear  constraints  resulting  from  the  syntax-directed 
editor,  the  user  interaction  with  the  syntax-directed  editor  was  to  be  reduced  and 
the  focus  placed  on  the  graph  editor.  As  this  project  is  an  evolution  of  the  current 
PSDL  Editor,  the  existing  architecture  of  a  syntax/semantics  checker  and  a  graph 
editor  was  maintained.  With  the  user's  focus  being  placed  on  the  graph  editor,  an 
expanded  interface  was  required  between  the  syntax/semantics  checker  and  the  graph 
editor.  This  change  in  focus  also  required  a  redistribution  of  the  embedded  syntax 
and  semantic  knowledge  between  the  two  editor  segments. 

This  research  concentrated  on  the  development  of  the  graph  editor.  The  syn- 
tax/semantics checker  was  implemented  as  an  Ada  program,  refered  to  as  the  back- 
ground checker,  in  a  parallel  development  effort  by  Professor  Man-Tak  Shing.   The 
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Table  VIII.  PSDL  Interface  Structures  Summary 


Structure 

Description 

Direction 

GRAPH_DESC 

Representation  of  a  single  operator  plus 
some  "global"  data. 

SDE  +->  GE 

ERROR-MSGS 

Semantic  errors  detected  by  the  syntax- 
directed  editor. 

SDE  -»  GE 

ACTION 

Control  requests  for  next  action  to  be 
taken  by  the  syntax-directed  editor. 

SDE  «-  GE 

integration  of  the  the  background  checker  and  the  graph  editor  was  a  shared  task.  In 
order  to  accomplish  this  parallel  development,  a  new  interface  was  established.  Unlike 
the  interface  which  was  utilized  in  the  CAPS  Release  1  PSDL  Editor,  which  shared 
a  minimal  set  of  data  flow  diagram  data,  this  interface  shared  the  complete  specifi- 
cation of  a  single  PSDL  operator.  Additional  data  was  shared  to  provide  "global" 
prototype  information  to  the  graph  editor  was  well  as  to  support  control  functions. 
The  interface  was  defined  by  the  file  ge.interface.h  (reference  the  source  listing  of 
ge_interface.h  found  in  Appendix  D  on  page  195). 

Figure  17  depicts  the  interfaces  of  the  PSDL  Editor.  External  interfaces  to 
the  PSDL  Editor  provide  for  the  reading/writing  of  the  PSDL  code  as  well  as  for 
user  interaction  with  the  editor  through  the  Graphical  User  Interface.  Internally, 
all  editor  segment  communication  is  performed  through  the  ge.interface.h  data 
structures,  represented  by  the  dashed  box  inside  the  PSDL  Editor  of  Figure  17.  The 
ge_interface.h  file  contains  three  structures  used  to  organize  communications  be- 
tween the  background  checker  and  the  graph  editor.  These  structures  are  summarized 
in  Table  VIII. 

The  GRAPH_DESC  interface  accommodates  the  representation  of  a  single  PSDL 
operator.  This  is  symbolized  by  the  box  around  operator  d  with  an  arrow  pointing 
to  the  GRAPH_DESC  data  structure  in  Figure  17.   The  interface  does  not  support  the 
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Figure  17.  PSDL  Editor  Interfaces 
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PSDL  representation  of  the  operator17.  Instead,  coming  from  a  PSDL  file,  the  PSDL 
code  is  parsed  by  the  background  checker  and  attribute  values  are  stored  in  the 
prototype  data  structure,  local  to  the  background  checker.  PSDL  reserved  words  are 
removed.  The  association  of  an  attribute  value  with  a  PSDL  construct  is  provided 
implicitly  in  the  data  structure.  In  the  other  direction,  coming  from  the  Graphical 
User  Interface,  attribute  values  entered  by  the  user  are  associated  with,  and  stored 
into,  the  GraphObjectList  data  structure,  local  to  the  graph  editor.  It  is  not  until 
the  prototype  is  written  to  disk  by  the  background  checker  that  the  attribute  values 
are  mapped  into  PSDL  code. 

A.      SYNTAX  AND  SEMANTIC  KNOWLEDGE  DISTRI- 
BUTION 

Since  only  a  representation  of  the  PSDL  operator  is  shared  between  the  back- 
ground checker  and  the  graph  editor,  the  majority  of  the  embedded  syntactical  knowl- 
edge must  reside  in  the  background  checker.  The  background  checker  is  responsible 
for  the  input  parsing  of  a  PSDL  prototype  as  well  as  the  generation  of  the  PSDL  code, 
which  is  the  output  of  the  PSDL  Editor.  The  syntactical  knowledge  embedded  within 
the  graph  editor  is  limited  to  that  required  to  validate  the  user  supplied  data  values 
associated  with  a  PSDL  construct  and  limited,  locally-scoped,  semantic  validation. 

A  syntactically  correct  PSDL  prototype  is  ensured  in  a  two  step  process.  First, 
all  user  supplied  data  values  are  validated  prior  to  acceptance  into  the  graph  editor's 
data  structures.  Second,  all  PSDL  code  is  generated  by  the  background  checker, 
based  on  the  inputs  provided  by  the  user  from  the  graph  editor. 

It  is  critical  that  the  PSDL  Editor  generate  syntactically  correct  prototypes. 
No  matter  what  stage  of  a  prototype's  development,  the  prototype  must  be  syntac- 
tically correct.    All  viewing/editing  of  a  prototype  is  accomplished  from  the  graph 


17The  ge_interf  ace  .h  accommodates  some  PSDL  code  in  order  to  facilitate  the  editing  of  selected 
PSDL  constructs  which  were  too  complex  for  the  initial  implement  of  the  graph  editor's  user  interface. 
This  includes  all  PSDL  types  and  expressions. 
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editor.  The  graph  editor  does  not  receive  or  transmit  the  PSDL  code.  The  code  is 
encoded  into  the  GRAPH_DESC  data  structure  by  the  background  checker.  The  back- 
ground checker  is  only  capable  of  encoding  the  PSDL  code  into  the  internal  data 
structure  representation  if  it  can  parse  the  code.  Currently,  the  background  checker 
does  not  have  any  provisions  for  error  correction  of  a  syntactically  incorrect  prototype. 
The  CAPS  PSDL  Editor  can  not  be  used  to  edit  a  syntactically  incorrect  prototype. 

The  graph  editor  is  embedded  with  a  limited  amount  of  PSDL  semantic  knowl- 
edge. Semantic  consistency  is  primarily  accomplished  by  limiting  the  user's  options 
to  those  that  are  semantically  correct.  The  graph  editor  is  limited  to  semantic  issues 
that  are  local  to  an  operator.  The  interface  between  the  background  checker  and  the 
graph  editor  is  limited  to  a  single  operator.  All  global  semantic  issues  are  resolved 
by  the  background  checker. 

Note  that  while  a  prototype  which  is  not  semantically  correct  can  not  be 
translated  and  executed  by  the  Execution  Support  tools,  it  is  not  necessary  that 
the  prototype  be  semantically  correct  to  be  edited  with  the  PSDL  Editor.  There 
are  potential  semantically  incorrect  prototypes  which  are  not  compatible  with  the 
PSDL  Editor.  However,  there  is  no  general  limitation  against  semantically  incorrect 
prototypes  as  there  are  with  syntactically  incorrect  prototypes. 

B.      USER  SPECIFIED  PSDL  CONSTRUCTS 

It  is  the  graph  editor  that  provides  the  user  interface  for  PSDL  Editor.  The 
graph  editor  does  not  understand  PSDL  syntax.  Instead,  the  graph  editor  deals  with 
a  small  collection  of  data  objects  from  which  a  PSDL  construct  is  built.  It  is  the 
data  objects  provided  by  the  user  which  are  properly  formatted  with  PSDL  reserved 
words  by  the  background  checker  to  produce  a  PSDL  prototype  (i.e.,  PSDL  code). 
The  data  types  which  must  be  supported  by  the  graph  editor  can  be  derived  from  the 
PSDL  grammar  (reference  Appendix  A).  Table  IX  lists  the  fundamental  data  objects 
which  must  be  supported  by  the  graph  editor.  Production  rules  provided  in  Table  IX 
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Table  IX.  Fundamental  PSDL  Data  Objects 


PSDL  Data  Object 

Defining  Production  Rule 

id 

41 

id  list 

11 

operator  id 

24 

type  name 

10 

integer  literal 

43 

text 

49 

enumeration 

Table  X.  Enumeration  Values 


Enumeration  Usage 

Enumeration  Values,  separated  by  '  1 ' 

Operator  Type 

Implementation  Language 

Trigger 

Timing 

Time  Literal  Units 

State  Stream  Selection 

Operator    1   Terminator 
ADA    I    TAE    I    Others 
unprotected    1    By  Some    1    By  All 
Non-Time  Critical    1    Periodic    1    Sporadic 
microsec    1   ms    1    sec    1   min    1   hour 
Yes    1    No 

refer  to  those  specified  in  Appendix  A  which  define  the  syntax  of  the  data  object. 

Enumeration  values  are  provided  in  Table  X.  Some  of  the  enumeration  val- 
ues correspond  to  PSDL  reserved  words.  However,  some  are  used  to  free  the  user 
from  implementation  details  of  PSDL.  For  instance,  the  operator  type  (i.e.,  Operator 
I  Terminator)  does  not  correspond  to  any  PSDL  construct.  The  selection  of  a 
Terminator  is  encoded  by  setting  the  Maximum  Execution  Time  of  the  operator  to 
zero.  In  this  case,  the  use  of  an  enumerator,  along  with  semantical  knowledge  embed- 
ded in  the  graph  editor,  are  used  to  hide  this  implementation  detail  of  PSDL  from 
the  user. 

There  were  specific  PSDL  constructs  which  were  deemed  too  complex  to  be 
provided  in  the  initial  implementation  of  the  graph  editor's  user  interface.  Table  XI 
lists  those  constructs  for  which  syntactical  knowledge  was  not  embedded  in  the  graph 
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Table  XL  Complex  PSDL  Data  Objects 


PSDL  Data  Object 

Defining  Production  Rule 

data  type 

3 

interface 

7 

constraint  options 

29 

expression 

39 

initial  expression  list 

32 

editor.  In  order  to  provide  full  functionality  within  this  version  of  the  editor,  separate 
syntax  checkers  are  provided  for  these  constructs.  The  graph  editor  provides  a  text 
window  from  which  these  constructs  may  be  viewed/edited18. 

C.      HIERARCHICAL  STRUCTURE 

A  PSDL  prototype  is  implemented  as  a  network  of  operators,  which  may  or 
may  not  be  connected.  Syntactically,  a  PSDL  prototype  is  simply  a  set  of  operators19. 
A  given  operator  consists  of  a  specification  and  an  implementation  construct.  It  is 
the  data  flow  diagram,  contained  in  the  operator's  implementation,  which  describes 
the  prototype  network.  The  prototype  network  itself  is  decomposed  in  a  hierarchical 
manner,  described  by  a  tree,  in  which  each  operator  can  be  described  by  its  own 
network  of  PSDL  operators. 

Figure  18  depicts  the  skeleton  of  a  PSDL  prototype20.  The  prototype  consists 
of  nine  operator  components.  The  implementation  construct  of  the  root  operator, 
proto,  identifies  the  first  level  of  vertices  (i.e.,  operators)  and  edges  (i.e.,  streams) 


18  Syntactical  validation  of  these  constructs  is  required  in  order  to  maintain  a  syntactically  correct 
prototype.  As  of  this  writing,  this  facility  has  not  yet  been  provided. 

19Actually,  a  PSDL  prototype  is  a  set  of  operators  and  abstract  data  types.  However,  it  is  only 
the  operators,  which  includes  operators  of  an  abstract  data  type,  which  are  executed.  For  this 
discussion,  we  will  consider  operators  only. 

20The  code  presented  here  does  not  conform  to  the  CAPS  Release  2  semantics.  In  order  to  simplify 
the  example,  the  unique  identifier  suffixes  have  been  deleted.  The  unique  identifier  suffixes  will  be 
introduced  later  in  this  chapter. 
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Figure  18.  Sample  PSDL  Prototype 
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which  constitute  the  prototype  network.  Each  operator  identified  in  this  network 
is  contained  in  the  PSDL  prototype,  the  implementation  of  which  may  or  may  not 
be  described  as  a  network  of  PSDL  operators.  Figure  19  provides  a  corresponding 
hierarchical  representation,  along  with  a  simple  tree  representation,  of  the  PSDL 
prototype  provided  in  Figure  18. 

Note  that,  while  the  decomposition  of  the  PSDL  network  is  represented  as  a 
tree,  the  PSDL  network  itself  is  not  restricted  to  a  tree.  In  general,  the  PSDL  network 
can  be  implemented  as  a  disconnected  graph  containing  cycles.  Figure  20  depicts  how 
the  prototype  tree  structure  is  flattened  into  the  PSDL  network,  which  implements  the 
prototype,  proto.  For  each  level  of  the  tree,  the  resulting  PSDL  network  is  provided. 
The  resulting  network  is  representative  of  the  outcome  of  the  flattening  process  used 
by  the  Execution  Support  tools.  While  the  original  network  of  Figure  18,  described 
by  operator  proto,  was  a  simple  tree  consisting  of  three  vertices,  the  flattening  of  the 
PSDL  network  resulted  in  a  connected  graph  of  six  vertices  containing  a  cycle. 

The  tree  describes  the  relationship  between  operators,  not  the  communication 
paths  between  operators.  In  Figure  18,  operator  d  has  been  selected  as  the  current 
operator  of  interest.  From  Figure  19,  it  can  be  seen  that  operator  b  is  the  parent  and 
that  operators  f ,  g,  and  h  are  the  children.  Operator  proto  is  the  root  operator. 

Within  the  background  checker,  the  entire  PSDL  prototype  is  maintained. 
The  interfacing  data  structure,  GRAPH_DESC  (contained  in  ge.interface.h,  reference 
Appendix  D,  page  195),  only  facilitates  the  representation  of  one  operator.  The 
current  operator  being  edited  is  selected  by  the  user,  in  a  process  of  navigating  through 
the  prototype  tree  structure.  Initially,  the  root  operator  is  selected  by  the  PSDL 
Editor  as  the  current  operator. 

Thus,  for  the  prototype  depicted  in  Figure  18,  all  nine  operators  would  be 
maintained  simultaneously  within  the  background  checker's  data  structures.  Within 
the  graph  editor,  a  single  operator,  such  as  the  data  represented  by  the  shaded  rect- 
angle (operator  d)  in  Figure  19,  would  be  maintained.  Initially,  the  operator  proto 
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would  be  presented  to  the  user  by  the  graph  editor.  As  the  user  navigates  through  the 
operator  tree,  the  operator  represented  in  the  graph  editor  data  structures  is  replaced 
with  the  operator  selected  by  the  user.  It  is  the  responsibility  of  the  background 
checker  to  extract  and  relay  the  information  for  the  current  operator  to  the  graph 
editor. 

From  a  graph  editor  perspective,  at  most  four  levels  of  the  prototype  tree 
are  relevant  at  any  given  time.  It  is  the  responsibility  of  the  background  checker 
to  orchestrate  the  data  of  these  four  levels  with  the  information  contained  in  the 
GRAPH_DESC  data  structure.  These  four  levels  are  represented  in  Figure  21,  in  which 
the  graph  editor  has  no  visibility  into  the  shaded  regions21 .  The  operator  of  interest  is 
the  current  operator.  This  is  the  operator  which  is  being  edited.  Both  the  specification 
and  the  implementation  constructs  of  the  current  operator  are  available  for  viewing 
and  editing.  One  level  down  from  the  current  operator  are  the  children  operators. 
Portions  of  the  specification  construct  of  the  child  operator  are  available  for  viewing 
and  editing.  The  input/output  constructs  of  the  child's  specification  are  derived  from 
the  current  operator's  data  flow  diagram.  The  functionality  constructs  of  the  child's 
specification  are  also  made  available  through  the  editing  of  operator  options  in  the 
current  operator's  data  flow  diagram.  Also  available  from  the  operator  options  is  the 
implementation  language  of  the  child  operator.  One  level  above  the  current  operator 
is  the  parent.  The  parent  operator  is  used  by  the  background  checker  to  derive  the 
current  operator's  specification  construct  (i.e.,  the  input  and  output  constructs).  The 
parent  operator  is  not  directly  visible  from  the  graph  editor.  The  final  level  which  is 
visible  is  the  root  level.  The  actual  root  operator  is  not  visible  (unless  it  is  the  current 
operator).  However,  the  root  level  contains  global  information,  which  is  visible  from 
any  level.  Specifically,  abstract  data  types  are  global  to  the  prototype  and  are  visible 
from  any  level  of  the  prototype  tree. 


21  Note  that,  while  the  graph  editor  may  have  visibility  into  a  region  which  is  not  shaded,  the 
graph  editor  does  not  necessarily  have  the  ability  to  write  to  an  area  that  is  not  shaded.  Much  of 
this  visibility  is  provided  by  the  background  checker  providing  derived  information  on  the  prototype. 
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The  background  checker  is  responsible  for  deriving  the  values  to  be  inserted 
into  the  GRAPH_DESC  data  structure.  Figure  22  provides  the  GRAPH_DESC  data  struc- 
ture extracted  from  ge_interface.h.  Within  the  GRAPH_DESC  data  structure,  the 
background  checker  provides  several  references  to  the  prototype  levels  just  discussed, 
starting  with  the  current  operator  being  identified  by  cur_op_name  and  cur_op_num. 
From  this  starting  point,  all  children  are  readily  available  through  the  data  flow  di- 
agram. However,  the  parent  can  not  be  derived  from  the  current  operator.  The 
background  checker  provides  a  reference  to  both  the  parent,  parent _op_name  and 
parent _op_num,  as  well  as  the  root,  root_op_name  and  root_op_num. 

The  current  operator's  specification  is  supported  using  several  symbols.  The 
cur_op_spec  provides  the  PSDL  code.  The  specification  construct  must  be  derived 
by  the  background  checker.  The  input  and  output  constructs  are  derived  from  the 
parent  operator's  data  flow  diagram.  This  was  seen  in  Figure  19,  where  the  input 
and  output  streams  of  operator  d  could  be  derived  from  the  data  flow  diagram  of  the 
parent  operator,  operator  b.  In  this  case,  streams  x  and  s  were  the  input  streams 
and  z  was  the  output  stream.  In  order  to  minimize  the  PSDL  syntactical  knowl- 
edge required  by  the  graph  editor,  the  background  checker  provides  a  partial  parsing 
of  the  operator's  specification.  The  operator's  input  stream  list,  input  .list,  out- 
put stream  list,  output-list,  and  maximum  execution  time,  cur_op_spec_met  and 
cur_op_spec_met_unit,  are  all  provided  as  objects  which  can  be  operated  on  by  the 
graph  editor.  Note  that  a  portion  of  the  current  operator's  specification  is  dependent 
upon  the  current  operator's  implementation.  For  example,  the  list  of  states  provided 
in  the  specification  are  derived  from  the  current  data  flow  diagram.  For  such  cases, 
the  PSDL  code  provided  in  cur_op_spec  is  not  maintained  while  in  the  graph  editor. 
The  background  checker  will  update  these  constructs  as  requested. 

The  current  operator's  implementation  is  composed  of  several  objects.  The 
majority  of  the  operator's  implementation  is  provided  in  the  data  flow  diagram.  In 
addition,  a  list  of  timers,  timer_list,  and  the  data  flow  diagram's  informal  descrip- 
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/*  typedef  for  the  graph  description  structure 

typedef  struct  graph_desc_node{ 
/*  From  SDE  to  GE  */ 
char*  root_op_name; 
int    root_op_num; 
char*  parent_op_name ; 
int   parent_op_num; 
char*  current_op_name; 


current_op_num; 


/*  name  of  the  root  operator  */ 

/*  unique  op_num  of  the  root  operator  */ 
/*  name  of  the  parent  of  the  current  operator  */ 

/*  unique  op_num  of  the  parent  operator  */ 
/*  name  of  the  current  operator 

whose  dataflow  graph  is  being  edited  */ 

/*  unique  op_num  of  the  current  operator  */ 


/*  From  SDE  to  GE  */ 
ST_LIST  input_list; 
ST_LIST  OUtput_list; 


/*  list  of  input  streams  */ 

/*  list  of  output  streams  */ 

/*  NOTE:  only  label,  label_font,  stream_type_name, 
state_initial_value,  is_state_variable  are 
meaningful  in  the  input_list  and  output_list  */ 


/*  From  SDE  to  GE  */ 

int     cur_op_spec_met ; 

int     cur_op_spec_met_unit ; 


/*  MET  is  kept  separate  from  the  spec      */ 
/*  interface.   Still,  only  the  reqmts  can  */ 


/*  MTS  11/25/96 

change  cur_op_is_terminator  from  int  to  BOOLEAN  */ 
BOOLEAN      cur_op_is_terminator ; 

/*  Bi-directional  between  SDE  and  GE  * / 

char*    cur_op_spec;  /*  Specification  of  current  operator  which  */ 

/*  is  edited  with  mini-sde.  */ 

/*  Bi-directional  between  SDE  and  GE  * / 

OP_LIST  operator_list; 

ST_LIST  stream_list; 

ID_LIST  timer_list; 

char*    graph_inf ormal_desc; 


/*  From  SDE  to  GE  */ 
ID_LIST  avail_impl_langs ; 


/*  An  ID_LIST  of  available  languages  from  */ 
/*  which  an  operator  can  be  implemented   */ 


/*  Bi-directional  between  SDE  and  GE  */ 

char*    global_types;  /*  SDE  output  of  all  types 

}  GRAPH_DESC_NODE,  *GRAPH_DESC; 


Figure  22.  GRAPH_DESC  Extract 
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tion,  graph_inf  ormal_desc,  are  supported.  The  operator's  data  flow  diagram  is 
specified  by  a  linked  list  of  operators,  operator_list,  and  a  linked  list  of  streams, 
stream_list. 

All  abstract  data  types  are  provided  as  PSDL  code  in  global_types.  This 
implementation  of  the  graph  editor  does  not  provide  graphical  user  interface  support 
of  abstract  data  types.  However,  the  PSDL  code,  as  derived  by  the  background 
checker  is  made  available  to  the  graph  editor. 

Upon  returning  control  back  to  the  background  checker,  the  ge_interface.h 
data  structures  are  used  to  update  the  PSDL  prototype  components.  Primarily, 
this  involves  updating  the  current  and  child  operators.  However,  global  updates  of 
components  may  be  required  to  maintain  consistency  with  changes  introduced  in  the 
current  operator. 

D.      PSDL  VALIDATION  AND  GENERATION 

The  PSDL  Editor  ensures  a  syntactically  correct  prototype.  In  the  CAPS 
Release  1  PSDL  Editor,  all  of  the  syntactical  knowledge  was  embedded  in  the  syntax- 
directed  editor.  This  was  appropriate  since,  other  than  the  data  flow  diagram,  the 
prototype  was  edited  through  the  syntax-directed  editor.  With  the  focus  of  this 
implementation  being  on  the  graph  editor  and  the  graphical  user  interface,  the  proto- 
type is  now  fully  defined  from  the  graph  editor.  Even  with  this  change  of  focus,  it  is 
still  possible  to  maintain  the  majority  of  the  syntactical  knowledge  within  the  back- 
ground checker.  However,  with  the  editing  of  the  prototype  being  accomplished  in 
the  graph  editor  and  the  syntactical  verification  being  performed  in  the  background 
checker,  a  time  delay  is  inserted  between  the  entry  of  the  prototype  data  and  the 
detection  of  any  errors.  The  length  of  this  time  delay  is  dependent  upon  how  the 
graph  editor  and  background  checker  interface.  In  the  CAPS  Release  1  PSDL  Editor 
implementation,  the  syntax-directed  editor  generated  by  the  Synthesizer  Generator 
performed  incremental  validation  of  PSDL  syntax  as  the  user  typed  [Ref.  8].  For  this 
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implementation,  the  interface  between  the  background  checker  and  the  graph  editor 
is  accomplished  similar  to  batch  processing.  In  this  mode  of  operation,  an  operator 
is  edited  without  assistance  from  the  background  checker.  Upon  the  user  request  to 
verify  the  prototype,  or  upon  changing  the  current  operator  to  another  operator,  the 
background  checker  is  called  to  perform  syntax/semantic  validation. 

There  are  two  categories  of  errors  which  are  detected  by  the  PSDL  Editor: 
syntactic  and  semantic.  With  automatic  PSDL  code  generation  by  the  background 
checker,  syntactical  errors  are  limited  to  user  supplied  input.  Semantic  errors  are 
generally  more  global,  typically  involving  one  or  more  operators.  Typically,  semantic 
errors  which  are  detected  are  based  on  a  relationship  between  two  symbols.  With 
this  distinction  between  the  nature  of  the  two  categories  of  errors,  it  seemed  reason- 
able to  move  the  detection  of  syntactical  errors  to  the  graph  editor,  avoiding  any 
delays  introduced  with  a  batch  mode  of  operation,  while  semantic  error  detection 
being  performed  within  the  background  checker.  With  the  current  architecture  of 
the  background  checker  and  the  graph  editor,  certain  semantic  errors  can  only  be  de- 
tected from  the  background  checker,  since  only  the  background  checker  has  a  global 
perspective  of  the  prototype. 

In  addition  to  the  generation  of  the  PSDL  constructs  associated  with  user 
supplied  inputs,  the  PSDL  Editor  supplies  automatic  code  generation  for  redundant 
data.  This  feature  is  most  apparent  in  the  generation  of  PSDL  code  to  support  both 
the  specification  and  implementation  constructs  of  an  operator. 

1.       Validation  of  PSDL  Constructs  by  the  Graph  Editor 

The  graphical  user  interface  of  the  PSDL  Editor  facilitates  the  validation  of 
user  supplied  PSDL  constructs.  Validation  of  user  inputs  are  performed  prior  to 
updating  the  graph  editor  internal  data  structures.  In  this  manner,  all  user  sup- 
plied inputs  are  validated  prior  to  being  relayed  back  to  the  background  checker.  All 
fundamental  PSDL  data  objects  listed  in  Table  IX  are  validated  by  the  graph  editor. 
Table  XII  provides  the  routines  and  state  machines,  as  applicable,  in  which  the  funda- 
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Table  XII.  Fundamental  PSDL  Data  Object  Validation 


PSDL  Data  Object 

Rule 

State  Machine 

Routine 

id 

41 

N/A 

valid_id 

id  list 

11 

N/A 

valid_id,  checked  individually 

operator  id 

24 

Figure  23 

valid_op_id 

type  name 

10 

Figure  24 

valid_type_name 

integer  literal 

43 

N/A 

valid_integer_literal 

text 

49 

N/A 

Motif 

enumeration 

Motif 

mental  data  objects  are  validated.  Validation  routines  are  found  in  ge_utilities  .c, 
which  is  included  in  Appendix  D,  starting  on  page  202.  All  enumeration  values  listed 
in  Table  X  are  validated  by  the  graphical  user  interface  by  only  allowing  the  user  to 
select  one  value  from  a  predefined. list. 

For  the  complex  PSDL  data  objects  listed  in  Table  XI,  the  graph  editor  does 
not  contain  the  syntactical  knowledge  to  validate  user  supplied  input.  While  required, 


Figure  23.  (opJd)  Validation  State  Machine 
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Figure  24.  (type-name)  Validation  State  Machine 

the  facilities  needed  to  provide  this  validation  have  yet  to  be  implemented. 

2.        PSDL  Redundant/Derived  Data 

The  operator's  specification  defines  the  external  interface  of  the  operator  while 
hiding  the  details  of  the  implementation.  The  specification  provides  a  "summary" 
of  the  operator,  and  thus  contains  redundant  information  found  in  the  operator's 
implementation.  The  PSDL  Editor  provides  support  for  this  redundant  information. 
The  user  is  only  required  to  enter  data  once.  The  background  checker  is  equipped  with 
the  semantic  knowledge  required  to  derive  the  redundant  data.  In  addition  to  saving 
the  user  from  entering  redundant  information,  this  implementation  avoids  semantic 
errors  due  to  inconsistencies  between  redundant  data.  If  data  is  entered  twice,  there 
is  the  possibility  that  it  will  be  inconsistent.  If  it  is  only  entered  once,  there  is  no 
possibility  for  inconsistent  data. 

The  graphical  user  interface  designed  for  the  graph  editor  has  been  limited 
to  the  single  entry  of  redundant  data.  There  is  no  semantic  knowledge  regarding 
redundant  data  in  the  graph  editor.  All  redundant  data  processing  is  performed  by 
the  background  checker. 
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3.       PSDL  Semantic  Consistency  by  the  Graph  Editor 

While  limited  by  the  local  scope  of  a  single  operator,  the  graph  editor  is  still 
capable  of  enforcing  some  semantic  consistency. 

Within  the  scope  of  an  operator,  those  operators  used  to  implement  the  data 
flow  diagram  must  be  unique.  Uniqueness  of  operator  labels  does  not  apply  to  op- 
erators of  an  abstract  data  type.  Uniqueness  is  enforced  upon  user  entry  of  the 
operator  label.  The  routine  unique _op_id,  found  in  graph_object_list  .C  (reference 
Appendix  D,  starting  on  page  277),  is  used  to  test  for  uniqueness. 

The  characteristic  of  an  operator  being  implemented  as  a  composite  terminator 
(i.e.,  having  a  maximum  execution  time  of  zero)  is  inherited  by  all  operators  of  the 
data  flow  diagram.  The  graph  editor  enforces  this  inheritance  by  limiting  the  user  to 
the  use  of  only  terminators  within  the  graphical  user  interface. 

Unlike  the  scoping  rules  for  operator  labels,  which  must  be  unique  for  non-type 
operators  within  a  data  flow  diagram,  multiple  uses  of  a  stream  are  allowed  within  a 
data  flow  diagram.  While  each  operator  implements  its  own  type  of  stream  (i.e.,  data 
flow  stream  or  sampled  stream),  streams  also  contain  global  characteristics.  These 
include  stream  type,  state  stream,  and  initial  value.  The  graph  editor  provides  for 
the  propagation  of  these  characteristics  for  all  streams  within  the  data  flow  diagram. 
It  is  the  requirement  of  the  background  checker  to  maintain  consistency  of  these 
global  characteristics  external  of  the  current  operator.  The  graph  editor  enforces 
consistency  through  the  routine  propagate.stream,  found  in  graph_object_list.C 
(reference  Appendix  D,  starting  on  page  277). 

With  a  global  perspective,  the  background  checker  is  capable  of  providing  ad- 
ditional semantic  validation.  Specifically,  the  background  checker  has  provisions  for 
validating  the  input  and  output  streams  specifications  in  a  child/parent  relationship. 
As  was  seen  previously  in  Figure  19,  the  data  flow  diagram  of  the  parent  operator 
defines  the  inputs  and  outputs  to  the  child  operator.  When  a  child  operator  is  imple- 
mented with  a  PSDL  network,  the  external  input  and  output  streams  present  in  the 
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child's  data  flow  diagram  must  exactly  match  the  input  and  output  streams  found  in 
the  parent's  data  flow  diagram  [Ref.  3].  External  input  and  output  streams  which 
were  not  defined  in  the  parent's  data  flow  diagram  are  flagged  as  being  illegal  by 
the  background  checker.  Input  and  output  streams  defined  in  the  parent's  data  flow 
diagram  but  missing  from  the  child's  implementation  are  flagged  as  being  missing. 

In  these  two  cases,  it  is  beyond  the  capability  of  the  PSDL  Editor  to  deter- 
mine a  corrective  action.  Instead,  upon  detecting  the  error,  the  background  checker 
provides  an  error  message  to  the  user.  Facilities  are  provided  to  navigate  directly  to 
the  parent  or  child  operator  in  order  to  correct  the  problem. 

The  background  checker  provides  an  additional  test  to  warn  against  a  semantic 
violation.  As  was  previously  mentioned  in  Chapter  II,  PSDL  has  no  global  variables. 
However,  as  currently  implemented  in  CAPS  Release  1,  streams  are  global,  based  on 
the  stream  name.  The  background  checker  tests  for  the  use  of  global  streams  and 
provides  a  warning  on  its  use. 

Figures  25  through  27  provide  an  example  of  these  error  conditions  which  are 
detected  by  the  background  checker.  Figure  25  provides  the  parent  data  flow  diagram. 
Figure  26  provides  the  decomposition  of  operator  b  found  in  the  parent's  data  flow 
diagram.  Figure  27  depicts  the  resulting  error  messages  from  this  prototype.  In 
this  case,  the  parent's  data  flow  diagram  specifies  that  operator  op_b  shall  have  an 
input,  op_b_in,  and  an  output,  op_b_out.  Within  the  implementation  of  operator 
op_b,  found  in  Figure  26,  two  undefined,  external  streams  are  specified,  called  in 
and  out.  These  two  errors  are  reported  as  the  first  two  errors  in  Figure  27.  Next, 
the  lack  of  input  op_b_in  and  output  op_b_out  from  the  child's  implementation  are 
reported  as  the  next  two  errors  in  Figure  27.  Finally,  the  global  stream  x  is  defined 
both  in  the  parent's  data  flow  diagram  and  the  child's  data  flow  diagram,  without  the 
stream  being  passed  between  the  parent  and  the  child.  The  final  two  error  messages 
of  Figure  27  report  this  condition. 
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Figure  25.  Parent  Graph  Depicting  Errors 

E.       PSDL  SYNTAX  CHANGES 

Several  modifications  have  been  made  to  the  PSDL  grammar  in  support  of 
CAPS  Release  2.  The  new  PSDL  Editor  is  required  to  support  these  changes.  A  copy 
of  the  CAPS  Release  2  PSDL  grammar  is  provided  as  Appendix  A.  A  few  small  fixes 
have  been  incorporated,  such  as  updates  to  the  (letter)  and  (alpha  ^numeric)  pro- 
duction rules.  Previously,  these  rules  allowed  any  number  of  consecutive  underscore 
characters  ('_')  in  an  (id).  The  grammar  rules  have  been  changed  (reference  produc- 
tion rules  47  and  48  in  Appendix  A)  to  be  consistent  with  the  construct  of  identifiers 
in  Ada.  Another  small  change  was  the  generalization  of  the  implementation  language 
identifier  in  the  (typeJmpl)  and  (operator Jmpl)  production  rules  (reference  rules  17 
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Figure  26.  Child  Graph  Depicting  Errors 

and  18  in  Appendix  A).  Previously,  only  Ada  was  allowed  as  an  implementation22. 

Two  more  substantial  changes  were  made  to  the  PSDL  grammar  which  im- 
pact the  PSDL  Editor.  From  the  standpoint  of  the  user  interface,  these  changes  are 
transparent  to  the  user.  However,  both  require  support  from  the  PSDL  Editor  to 
implement. 

1.       PSDL  Data  Flow  Diagram  Properties 

In  CAPS  Release  1,  the  PSDL  file  generated  by  the  PSDL  Editor  was  sufficient 
to  support  the  Execution  Support  tools,  yet  was  not  sufficient  to  support  the  PSDL 


22 Currently,  the  only  supported  implementation  languages  are  Ada  and  TAE.  Facilities  have  been 
provided  in  the  grammar  for  future  supported  languages. 


63 


Figure  27.  Syntax-Directed  Editor  Error  Messages 
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Editor.  The  PSDL  Editor  provided  an  additional  file,  with  an  extension  of  ".grf", 
to  facilitate  the  presentation  of  the  data  flow  diagram.  In  CAPS  Release  1,  the 
PSDL  grammar  did  not  have  provisions  to  capture  the  full  specification  of  the  data 
flow  diagram  (i.e.,  the  visual  presentation  requirements).  In  CAPS  Release  2,  the 
PSDL  grammar  has  been  updated  with  a  property  construct  (reference  production 
rules  21,  22,  and  23  in  Appendix  A)  for  this  purpose.  This  change  provides  for  the 
tagging  of  properties  to  vertices  and  edges  of  a  data  flow  diagram  based  on  predefined 
identifiers.  These  properties  capture  the  information  which  was  previously  recorded 
in  the  ".grf"  file.  A  list  of  these  identifiers  was  provided  in  Chapter  II  as  Table  VI 
(page  38).  Currently,  these  properties  are  only  used  by  the  PSDL  Editor. 

2.       Unique  Identifier  Suffixes  in  CAPS  Release  2 

CAPS  Release  2  introduced  a  new  semantic  convention  for  the  purpose  of 
enforcing  PSDL  scope  rules.  Professor  Berzins  described  the  conventions  used  in  his 
email  dated  25  July  1996,  which  has  been  provided  as  Appendix  C. 

The  semantics  of  PSDL  requires  that  the  operators  within  a  composite  PSDL 
operator  (i.e.,  an  operator  which  has  been  implemented  with  a  PSDL  network)  be 
local  to  that  operator.  The  scoping  of  operators  is  illustrated  in  Figure  28,  a  portion 
of  a  PSDL  prototype,  in  which  operators  fm_a  and  f m_b  both  contain  operators  with 
common  names,  x,  yet  are  local  to  their  respective  parent  operator.  However,  this 
only  applies  to  PSDL  operators.  Scoping  for  operators  of  a  PSDL  type  are  global,  as 
PSDL  types  are  globally  available  within  the  prototype  heirarchy.  Thus,  t.x  refers 
to  the  same  operator  of  t,  from  both  fm_a  and  fm_b.  Note  that  within  an  operator, 
PSDL  operator  names  must  be  unique,  as  was  described  previously. 

In  order  to  implement  the  PSDL  scoping  rules,  unique  integer  suffixes  are 
attached  to  the  PSDL  operator  identifiers,  thus  ensuring  that  all  PSDL  operators 
are  unique.  In  addition  to  supporting  the  scoping  rules  of  PSDL  operators,  suffixes 
are  also  used  to  support  multiple  instances  of  PSDL  type  operators  within  the  same 
graph.   Thus  each  operator,  both  PSDL  operators  as  well  as  PSDL  type  operators, 
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Figure  28.  Scope  of  PSDL  Operators 

are  assigned  a  vertex  number  within  a  data  flow  diagram.   In  addition,  each  PSDL 
operator  is  assigned  an  operator  number.  The  convention  is  as  follows: 

(opjname)  -(op-num)  -(vertex  jaum) 
(type -op -name)  -(vertex  jnum) 

The  above  prototype  portion  is  depicted  again  in  Figure  29,  in  which  suffices  have 
been  included. 

Note  that  this  is  actually  not  a  syntax  change.  The  inclusion  of  operator  and 
vertex  number  suffixes  is  within  the  syntax  of  an  (id)  (reference  production  rule  41  in 
Appendix  A).  The  use  of  suffixes  to  implement  the  PSDL  scoping  rules  is  a  semantic 
convention  which  is  used  by  the  CAPS  subsystems.  The  implementation  of  the  suffix 
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Figure  29.  PSDL  Operator  Suffixes 

convention  is  to  be  hidden  from  the  PSDL  Editor  user,  thus  requiring  the  PSDL 
Editor  to  fully  automate  its  suffix  behaviour. 
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IV.         USER-INTERFACE  DESIGN 

The  core  of  a  PSDL  prototype  is  the  data  flow  diagram.  In  the  CAPS  Release 
1  PSDL  Editor,  the  graph  editor  was  solely  used  to  edit/view  the  data  flow  diagram. 
Following  the  editing  of  the  data  flow  diagram,  the  syntax-directed  editor  was  used  to 
edit  all  other  constructs  of  the  prototype.  This  release  of  the  PSDL  Editor  attempts 
to  streamline  the  editing  process  of  a  PSDL  prototype  by  focusing  the  user  interaction 
to  the  graph  editor. 

From  an  inspection  of  the  PSDL  grammar  (reference  Appendix  A),  it  can  be 
seen  that  a  large  number  of  PSDL  constructs  can  be  synthesized  by  the  editor,  using 
simple  user  provided  data  objects  (e.g.,  literal  values,  text  strings,  identifiers,  and  list 
of  identifiers).  As  a  PSDL  prototype  consists  of  a  network  of  operators  connected 
by  streams,  the  PSDL  constructs,  and  hence  the  user  provided  data  objects,  are  all 
associated  with  either  an  operator  or  a  stream.  The  only  exception  being  abstract 
data  types.  Thus,  a  graphical  user  interface  model  was  developed,  which  build  upon 
the  earlier  data  flow  diagram  effort  of  the  CAPS  Release  1  graph  editor,  with  the 
addition  of  pop-up  windows  associated  with  operators  and  streams  for  the  entry  of 
user  provided  data  objects. 

Complex  PSDL  constructs  (e.g.,  expressions),  as  discussed  in  Chapter  III,  are 
associated  with  operators  and  streams  as  well.  However,  the  complexity  of  these 
constructs  does  not  lend  themselves  to  a  simple  synthesis  from  user  provided  data 
objects.  As  an  initial  attempt  of  expanding  the  graphical  interface  of  the  PSDL 
Editor,  the  specification  of  these  constructs  was  maintained  in  PSDL  syntax. 

A  large  portion  of  the  graphical  interface  produced  by  Captain  Robert  Dixon, 
USMC  [Ref.  13],  was  maintained  in  this  implementation.  Primarily,  the  interface 
used  for  the  data  flow  diagram  was  preserved,  with  a  few  enhancements.  Expansion 
of  the  graphical  interface  was  partially  outlined  as  part  of  the  NPS  CS4520  ( AY96Q4) 
class  project,  implemented  by  Mr.    Douglas  Lange  and  Mr.    Dagohoy  Anunciado. 
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Additional  modifications  and  enhancements  to  the  interface  were  a  result  of  this 
research. 

A.      PSDL  EDITOR  ENVIRONMENT 

The  graphical  user  interface  provided  in  CAPS  Release  1  (i.e.,  the  graph  edi- 
tor's interface)  was  built  upon  the  X  Window  System23,  using  the  Motif24  widget  set. 
The  selection  of  Motif  for  use  in  the  CAPS  Release  1  PSDL  Editor  was  discussed  in 
Captain  Dixon's  thesis  [Ref.  13].  Motif  provides  assistance  in  the  development  of  an 
application  by  providing  a  standard  look  and  behavior  to  the  user  interface. 

1.       PSDL  Editor  Layout 

The  PSDL  Editor's  graphical  user  interface  is  designed  to  facilitate  the  speci- 
fication of  a  PSDL  operator.  As  was  discussed  previously,  the  user  interface  is  limited 
to  a  single  PSDL  operator  at  any  given  time.  The  PSDL  Editor  does  not  provide  for 
the  implementation  language  (e.g.,  Ada)  editing  of  an  operator. 

The  PSDL  Editor's  graphical  user  interface  is  depicted  in  Figure  30.    The 

graphical  user  interface  consists  of  six  areas,  which  are  identified  in  Figure  30  and 

discussed  in  the  following  paragraphs.     Pop-up  windows  are  used  to  support  the 

specification  of  constructs  directed  at  streams  and  operators  of  a  data  flow  diagram. 
a.         Main  Window 

This  is  the  X  Window  from  which  the  user  interacts  with  the  PSDL 

Editor.    The  Main  Window  is  equipped  with  a  title  along  with  several  control 

widgets  on  the  top  bar.  The  title  is  composed  of  "PSDL  Editor : "  and  the  name  of  the 

prototype.  The  prototype  name  is  based  on  the  file  name  (i.e.,  name  of  root  operator) 

provided  upon  execution  of  the  PSDL  Editor.  If  no  file  name  is  provided,  the  title  is 

set  to  DEFAULT_PR0T0_NAME.  The  operation  of  the  control  widgets  is  based  on  the  X 


23 X  Window  System  is  a  trademark  of  the  X  Consortium. 
24  Motif  is  a  trademark  of  the  Open  Software  Foundation. 
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Tool  Bar  /  Menu  Bar 


Main  Window 


Status  Bar 


Figure  30.  PSDL  Editor  Layout 


Identification 
Bar 


Drawing 
Window 


Window  System  initialization.  Reference  Appendix  E  for  notes  on  customization  of 

the  Main  Window. 

b.         Menu  Bar 

Pull-down  menus  provide  easy  access  to  PSDL  Editor  functions.  Stan- 
dard access  to  the  pull-down  menus  is  supported,  accomplished  using  the  left-mouse 
button.  Figure  31  depicts  all  four  pull-down  menus.  Note  that  the  Menu  Bar  was 
distorted  in  the  generation  of  this  figure  in  order  to  display  all  four  menus  simulta- 
neously. Only  one  menu  is  available  at  a  time  in  the  PSDL  Editor. 
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Figure  31.  PSDL  Editor  Menus 

c.  Tool  Bar 

The  Tool  Bar  is  divided  into  two  areas  by  a  horizontal  line.  Above 
the  line,  buttons  are  provided  to  access  tools  for  "drawing"  the  data  flow  diagram. 
Below  the  line,  buttons  are  provided  to  access  functions  for  editing  several  PSDL 
constructs.  The  functions  provided  here  are  relative  to  the  current  operator  or  are 
global  in  nature  (e.g.,  the  function  Types  is  directed  towards  abstract  data  types). 
As  will  be  seen  later,  other  functions,  available  through  pop-up  windows,  are  relative 
to  the  operators  and  streams  contained  in  the  data  flow  diagram.  The  functions  here 
(i.e.,  Spec,  Timers,  and  Graph  Desc)  are  directed  to  the  operator  indicated  in 
the  Identification  Bar. 

The  selected  drawing  tool,  above  the  horizontal  line,  is  independent  of 
any  tool  selected  below  the  horizontal  line.  While  drawing  functions  are  not  active 
during  the  use  of  a  tool  below  the  horizontal  line,  upon  exiting,  the  previously  selected 

drawing  tool  remains  in  effect  until  another  drawing  tool  is  selected. 

d.  Identification  Bar 

The  Identification  Bar  provides  the  name  of  the  current  operator 
(left  data  window)  as  well  as  the  maximum  execution  time  of  the  current  operator 
(right  data  window).  These  values  can  not  be  modified  at  this  level.  Instead,  the  user 
is  required  to  change  the  values  from  the  parent  operator's  data  flow  diagram.  The 
values  displayed  from  the  root  operator  can  not  be  changed. 
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e.  Drawing  Window 

This  area  is  used  to  display/edit  the  data  flow  diagram.    Scroll  bars 

are  provided  as  necessary  to  view  the  entire  data  flow  diagram  window.  Beyond  the 

area  accessed  through  the  window  scroll  controls,  the  Drawing  Window  can  not 

be  enlarged.  If  a  larger  drawing  area  is  required,  consider  decomposing  operators. 
/.  Status  Bar 

The  Status  Bar  provides  feedback  to  the  user.  Divided  into  three 
windows,  the  Status  Bar  provides:  (1)  an  indication  that  the  prototype  has  been 
modified  (SAVE  REQUIRED  versus  Save  Not  Required),  (2)  an  indication  that 
the  prototype's  syntax  should  be  verified  (Check  Syntax  versus  ERROR  MSGS), 
and  (3)  a  window  for  displaying  status  and  error  messages. 

The  first  two  indicators  are  button  widgets.  The  labels  on  the  buttons 
are  changed  as  required  to  provide  feedback.  Activation  of  the  button  provides  a 
short  cut  to  the  desired  function  (i.e.,  save  the  prototype,  perform  a  syntax  check, 
and  display  any  error  messages).  The  last  indicator  provides  an  area  to  provide 
editor  feedback.  Typically,  an  information  pop-up  window  is  used  to  display  an 
editor  message.  This  window  is  used  to  remind  the  user  after  the  pop-up  window 
has  been  acknowledged.  The  window  is  automatically  erased,  typically  on  the  next 
operation. 

2.       Component  Identification 

From  the  Main  Window,  the  user  can  access  an  Operator  Property  or  Stream 
Property  pop-up  window.  This  is  accomplished  by  positioning  the  cursor  over  an 
object  in  the  Drawing  Window  and  pressing  the  right-mouse  button.  The  appro- 
priate pop-up  window  will  be  accessed.  Figures  32  through  34  provide  an  example  of 
the  these  three  windows.  Component25  Identification  numbers  are  provided,  which 
reference  into  Table  XIII  (Index),  providing  identification  of  all  displays/controls. 


25In  this  case,  component  refers  to  a  Motif  widget  and  not  to  a  PSDL  component. 
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PSOk  Mitoi:    avionlcs_«xai»>»l<.' 


Figure  32.  PSDL  Editor  Component  Identification 
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Figure  33.  PSDL  Editor  Operator  Pop-up  Component  Identification 


Figure  34.  PSDL  Editor  Stream  Pop-up  Component  Identification 
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3.        Types  of  Components 

Under  the  Component  Type  column  of  Table  XIII,  the  various  types  of  user 
interaction  are  identified.  The  PSDL  Editor  utilizes  a  limited  set  of  widgets  to  interact 
with  the  user.  These  components  are  used  both  for  editing  a  data  object  as  well  as 
viewing  a  data  object.  Typically  there  is  not  sufficient  space  within  a  window  to  view 
all  of  a  data  type.  Controls  are  used  to  access  additional  Motif  widgets  from  which 
the  entire  data  object  can  be  viewed/edited.  In  most  cases,  an  indication  is  provided 
that  additional  information  is  available  through  a  pop-up  window. 

The  data  flow  diagram  requires  significant  interaction.  It  will  be  discussed  in 

another  section. 

a.  Display  Only 

This  widget  provides  no  input/control  functionality.  It  is  only  used  to 
display  data.  Data  may  be  obtained  from  the  editor  and  displayed,  as  is  the  case  for 
the  Current  Operator  Name  (Index  5).  Alternatively,  the  input  may  be  provided  by 
the  editor,  but  accessed  from  a  control  button,  as  in  the  case  of  Trigger  Id  Condition 

Expression  (Index  26)  which  is  accessed  from  the  Trigger  If  Condition  (Index  25). 

b.  Data  Entry 

This  widget  provides  direct  data  entry  through  the  keyboard.  Prior  to 
data  entry,  ensure  that  the  mouse  cursor  is  positioned  within  the  Data  Entry  window. 
The  user  can  scroll  through  the  Data  Entry  window  using  the  left  and  right  arrow 

keys,  as  required. 

c.  Select 

This  widget  provides  a  select-one-of  function.  Values  act  similar  to  an 
enumeration  type.  Values  are  predefined  and  only  one  value  can  be  selected.  The 
Select  type  may  be  either  a  radio  widget,  such  as  State  Stream  Selection  (Index 
50),  or  a  pull-down  version,  such  as  Implementation  Language  (Index  22).  The  pull- 
down version  is  activated  by  depressing  and  holding  the  left-mouse  button  over  the 
component.  Move  the  cursor  over  the  desired  value  and  release  the  mouse  button. 
An  example  of  the  Implementation  Language  widget  is  provided  in  Figure  35.  Note 
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Figure  35.  Select  Component 

that,  in  this  example,  the  cursor  is  not  visible. 

d.  Control 

Control  widgets  are  accessed  by  depressing  the  left-mouse  button  over 

the  component. 

e.  Control- Text 

Control-Text  components  access  a  pop-up  Text  window.  An  example 
of  a  Text  Window  is  provided  in  Figure  36,  in  which  the  prototype's  abstract  data 
types  were  accessed  through  the  Types  Tool  (Index  14). 

Within  the  Text  Window,  the  user  can  position  the  cursor  with  the 
mouse  and  edit  the  text.  The  cursor  must  remain  within  the  Text  Window  while 
editing  the  text.  Scroll  bars  are  provided  for  moving  through  the  text.  Initially, 
all  changes  made  within  the  Text  Window  are  local  to  the  Text  Window.   In  order 
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Figure  36.  Text  Window  Component 

to  modify  the  prototype,  the  changes  must  be  accepted.    This  is  accomplished  by 

depressing  the  OK  button.    Changes  may  be  aborted  by  depressing  the  Cancel 

button. 

/.  Control-IdList 

Control-IdList  components  access  a  pop-up  identifier  list  editor.  Within 
this  window,  a  list  of  identifiers  may  be  viewed/edited.  An  example  of  an  Id  List 
Window  is  provided  in  Figure  37,  in  which  the  operator's  Timer  list  is  accessed 
through  the  Timers  Tool  (Index  16). 

From  the  Id  List  Window,  the  identifier  list  can  be  viewed  directly.  In 
order  to  add  an  identifier,  the  Add  button  is  depressed.  A  pop-up  window  is  provided 
to  add  the  identifier  to  the  list.  The  new  identifier  is  accepted  locally  through  the  OK 
button.  The  addition  of  an  identifier  to  the  Id  List  is  depicted  in  Figure  38.  A  similar 
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Figure  37.  Identifier  List  Editor  Component 

process  applies  to  the  editing  of  an  existing  identifier.  However,  in  the  case  of  editing 
an  identifier,  the  identifier  must  first  be  selected.  Otherwise  an  information  message 
will  be  displayed  to  select  an  identifier  first.  In  order  to  delete  an  identifier  from  the 
list,  select  the  identifier  and  depress  DELETE.  Again,  an  information  message  will  be 
displayed  if  an  identifier  is  not  first  selected. 

Like  the  Text  Window,  initially,  all  changes  made  within  the  Id  List 
Window  are  local.  In  order  to  modify  the  prototype,  the  changes  must  be  accepted. 
This  is  accomplished  by  depressing  the  OK  button.  Changes  may  be  aborted  by 
depressing  the  CANCEL  button. 

4.        Display  Indications 

Under  the  Indicator  column  of  Table  XIII,  the  various  methods  used  to  display 
data  are  identified.  Where  practical,  data  objects  are  displayed  within  the  window. 
However,  due  to  the  limited  space  within  a  window,  it  is  not  always  possible  to  display 
the  entire  value  of  a  data  object.  An  effort  was  made  to  indicate  to  the  user  where 
data  is  available.  This  is  not  universal,  in  that  the  tool  buttons  have  no  indication  of 
the  existence  of  data. 
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Figure  38.  Adding  to  an  Identifier  List 

As  for  the  data  flow  diagram,  it  is  visible  in  the  Drawing  Window.  However, 
in  order  to  view  all  attributes  of  the  data  flow  diagram,  the  stream  and  operator  pop- 
up windows  must  be  accessed.  The  only  method  available  to  view  the  entire  prototype 

is  through  the  PSDL  code  generated  by  the  PSDL  Editor. 
a.         Data 

A  Data  indication  can  be  viewed  directly  from  its  Data  or  Display  Only 

component.  The  user  can  scroll  within  the  data  window  through  the  use  of  the  left 

and  right  arrow  keys. 
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b.  Data... 

The  Data...  indication  is  similar  to  the  Data  indicator.  However,  in 
this  case,  the  data  value  is  typically  much  larger  than  the  display  window.  If  the  data 
value  will  not  fit  within  the  window,  the  data  value  is  truncated  and  a  set  of  epsilons 

(i.e.,  "...")  is  appended.  Use  the  control  mechanism  to  access  the  entire  data  value. 

c.  Enumeration 

The  current  Enumeration  value  is  indicated  directly  on  the  control  com- 


ponent. 


d.         Label 

A  Label  indication  is  similar  to  an  Enumeration  indication  in  that  any 


feedback  is  provided  directly  on  the  control  component. 
e.         Label... 

In  this  case,  much  like  the  Data...    indication,  a  set  of  epsilons  (i.e., 

"...")   is  appended  to  the  label  to  indicate  that  a  data  value  is  associated  with  the 

control  component.  Without  the  epsilons,  a  value  has  not  yet  been  assigned. 
/.  Hidden 

Not  all  data  objects  are  available  in  all  situations.  Some  data  objects 

are  context  depended.  For  example,  a  state  stream  initial  value  is  not  relevant  unless 

the  stream  is  a  state  stream.    As  a  method  of  enforcing  PSDL  semantics,  several 

components  are  displayed  based  on  the  context  of  the  operator/stream.   The  Hides 

column  of  Table  XIII  indicates  those  components  which  may  be  unavailable  due  to 

context.   Figure  39  depicts  the  case  of  a  stream  which  is  not  a  state  stream.   Here, 

the  State  Initial  Value  Control  (Index  51)  is  "grayed  out"  and  the  State  Initial  Value 

Display  (Index  52)  have  been  removed.  In  contrast,  Figure  34  depicts  a  state  stream 

in  which  both  of  these  components  are  available. 

5.       Cursor  Types 

Several  different  types  of  cursors  are  used  within  the  PSDL  Editor.  The  default 
cursor  is  the  left  pointer.  It  is  used  for  selecting  components  as  described  above. 
Within  the  Drawing  Window,  an  I-Bar  cursor  is  displayed  when  the  cursor  is  over 
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Figure  39.  Hidden  Components 

an  object  (i.e.,  data  stream  or  operator).  The  I-Bar  cursor  over  the  data  flow  diagram 
is  used  to  indicate  to  the  user  that  a  label  can  be  typed  in  directly.  Finally,  a  clock 
face  cursor  is  used  to  indicate  that  the  PSDL  Editor  is  busy.  The  clock  face  cursor  is 
typically  encountered  when  a  syntax  check  or  a  prototype  save  function  is  performed. 
More  will  be  said  regarding  the  I-Bar  cursor  in  the  Data  Flow  Diagram  paragraph 
below. 

6.       Mouse  Interface 

The  PSDL  Editor  requires  a  two  button  mouse.  The  left-mouse  button  is 
used  to  access  most  functions.  The  right-mouse  button  is  used  to  pull  up  the  Stream 
Property  or  Operator  Property  pop-up  window,  as  required.  This  is  accomplished  by 
placing  the  cursor  over  the  object  in  question  within  the  Drawing  Window  and 
depressing  the  right-mouse  button.  Again,  more  will  be  said  about  mouse  interaction 
in  the  Data  Flow  Diagram  paragraph  below. 
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Table  XIV.  PSDL  Editor  Hot  Keys 


Function 

Menu 

Control-key 

Diamond-key 

Go  to  Root 

PSDL 

CTRL-R 

0-R 

Go  to  Parent 

PSDL 

CTRL-P 

0-P 

Decompose 

PSDL 

CTRL-D 

0-D 

Refresh  Display 

Edit 

CTRL-F 

0-F 

7.       Hot  Keys 

Access  to  selected  menu  functions  is  available  through  Hot  Keys.  Those  menu 
items  with  Hot  Keys  are  identified  by  an  underscore  under  the  Hot  Key  letter  in  the 
pull-down  menu  (reference  Figure  31).  Table  XIV  lists  the  menu  functions,  along 
with  the  associated  key  sequence,  which  are  defined  Hot  Keys. 

B.  PSDL  MAPPING 

As  was  discussed  in  Chapter  III,  the  PSDL  Editor  focuses  the  user  on  one 
operator  at  a  time.  Figure  40,  similar  to  Figure  21  from  Chapter  III,  indicates 
the  general  mapping  of  the  PSDL  Editor  into  the  prototype.  The  PSDL  graphical 
user  interface  focuses  the  user  on  the  current  operator.  There  are  two  exceptions, 
the  Types  Tool  provides  for  the  specification  of  abstract  data  types,  at  the  root 
level,  and  the  Operator  Properties  pop-up  window  supports  the  functionality  of  child 
operators.  The  background  checker  provides  for  the  generation  of  redundant  code  in 
order  to  complete  the  operator's  specification  construct. 

C.  PSDL  EDITOR  OPERATION 

The  PSDL  Editor  is  operated  through  the  use  of  Menu  and  TOOL  Bar  func- 
tions and  pop-up  windows.  Upon  creating  a  new  prototype,  the  user  must  start  at 
the  root  level.  Abstract  data  types  may  be  entered  through  the  TYPES  Tool  at 
any  time.  However,  the  specification  of  the  hierarchical  tree  used  to  implement  the 
prototype  must  be  performed  top-down.    That  is,  the  structure  of  the  hierarchical 
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Figure  40.  Editor  to  PSDL  Mapping 
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tree  must  be  specified,  starting  with  the  root  and  proceeding  down  to  the  leaves.  De- 
velopment of  the  prototype  in  this  top-down  fashion  maintains  a  syntactically  correct 
prototype.  If  a  bottom-up  approach  was  provided,  the  prototype  would  no  longer  be 
syntactically  correct  at  each  stage  of  development.  The  detailed  implementation  of 
each  operator  can  be  specified  in  any  order. 

The  network  used  to  implement  each  PSDL  operator  is  specified  within  the 
Drawing  Window,  using  the  tools  provided  in  the  Tool  Bar.  Implementation 
details  for  each  composite  operator  and  stream  can  be  entered  through  pop-up  prop- 
erties windows.  Navigation  tools  are  provided  to  traverse  the  hierarchical  tree.  Any 
time  you  are  using  an  editor,  frequent  saves  are  recommended,  which  may  be  accessed 
through  the  Menu  Bar. 

Finally,  if  help  is  needed,  the  PSDL  Editor  provides  help  windows,  both  at  the 
Main  Window  as  well  as  for  pop-up  windows.  Help  is  accessed  through  a  text  window, 
as  illustrated  in  Figure  41,  with  scroll  bars  available  for  browsing  the  message.  Press 
the  OK  button  to  exit  help. 

1.       PSDL  Editor  Segment  Synchronization 

The  PSDL  Editor  consists  of  two  segments,  the  background  checker  and  the 
graph  editor,  which  operate  in  unison.  Each  segment  performs  a  portion  of  the 
editing  task.  The  background  checker  is  responsible  for  the  input  parsing  of  the 
PSDL  prototype,  extracting  operators  out  of  the  prototype  for  processing  by  the 
graph  editor,  global  syntax  and  semantic  validation,  and  the  generation  of  PSDL 
code.  The  graph  editor  is  responsible  for  providing  a  graphical  user  interface  which 
is  used  to  edit/view  the  prototype,  one  operator  at  a  time.  The  entire  prototype  is 
maintained  within  the  background  checker.  At  most  one  operator  can  be  processed  by 
the  graph  editor  at  a  time.  It  is  the  responsibility  of  the  background  checker  to  accept 
the  operator  inputs  from  the  graph  editor  and  to  assemble  them  into  a  prototype.  User 
directed  changes  to  the  prototype  are  introduced  in  the  graph  editor.  The  background 
checker  automatically  resolves  the  implications  of  the  graph  editor  produced  changes 
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Figure  41.  Help  Windows 

with  the  prototype.    In  the  event  that  a  discrepancy  can  not  be  resolved,  an  error 
message  is  fed  back  to  the  user. 

The  flow  of  information  between  the  two  PSDL  Editor  segments  was  depicted 
in  Figure  17  of  Chapter  III  (see  page  43).  After  processing  of  the  prototype,  the  back- 
ground checker  passes  control,  along  with  those  objects  described  in  ge_interface.h 
(reference  Appendix  D,  page  195),  to  the  graph  editor.  At  which  point  the  user  is 
allowed  to  edit  the  current  operator.  All  editing  of  an  operator  is  local  to  the  graph 
editor.  Specific  events,  requested  by  the  user,  result  in  control  being  passed  back  to 
the  background  checker.  During  these  events,  the  background  checker  synchronizes 
the  prototype  with  respect  to  the  graph  editor.  Synchronization  is  controlled  by  the 
ACTION  data  structure  of  ge_interface.h.  The  ACTION  data  structure  also  specifies 
if  control  is  to  be  returned  to  the  graph  editor  along  with  the  next  operator  to  be 
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Table  XV.  Synchronization  Events  and  Actions 


Button/Option 

Located  on 

Action 

Check  Syntax  button 

Status  Bar 

CHECK_SYNTAX 

SAVE  REQUIRED  button 

Status  Bar 

SAVE_TO_DISK 

Save  option 

File  Menu 

SAVE_TO_DISK 

Restore  From  Save  option 

File  Menu 

REVERT 

Exit  option 

File  Menu 

SAVE_TO_DISK  or  ABANDON 

Syntax  Check  option 

PSDL  Menu 

CHECK_SYNTAX 

Go  to  Root  option 

PSDL  Menu 

UPDATE.TREE 

Go  to  Parent  option 

PSDL  Menu 

UPDATE_TREE 

Decompose  option 

PSDL  Menu 

UPDATE_TREE 

Abandon  Changes  option 

Edit  Menu 

ABANDON 

processed. 

The  users  requested  events  which  result  in  the  synchronization  of  the  back- 
ground checker  and  the  graph  editor  are  listed  in  Table  XV.  Associated  with  each 
synchronization  event,  is  an  action.  Actions  are  also  defined  in  ge.interface.h. 

•UPDATE.TREE  synchronizes  the  graph  editor  operator  with  the  prototype  main- 
tained by  the  background  checker.  No  validation  is  performed. 

•CHECK_SYNTAX  synchronizes  the  graph  editor  operator  with  the  prototype  main- 
tained by  the  background  checker.  Syntax  and  semantic  validation  is  per- 
formed. 

•SAVE_TO_DISK  synchronizes  the  graph  editor  operator  with  the  prototype  main- 
tained by  the  background  checker.  Syntax  and  semantic  validation  is  per- 
formed. The  prototype  is  saved  to  a  file. 

•REVERT  synchronizes  the  graph  editor  with  the  prototype  version  which  resides 
on  disk  (i.e.,  version  that  was  last  saved). 

•ABANDON  synchronizes  the  graph  editor  with  the  prototype  residing  in  the  back- 
ground checker  memory.  Only  changes  made  since  the  last  time  the  prototype 
was  synchronized  are  abandoned. 

2.       Data  Flow  Diagram 

The  data  flow  diagram  is  specified  in  the  Drawing  Window.  The  PSDL 
Editor  provides  a  simple  drawing  package,  used  to  create/maintain  the  data  flow 
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Figure  42.  Data  Flow  Diagram  Symbols 

diagram.    Only  a  small  set  of  drawing  objects  are  required  to  represent  the  data 

flow  diagram.   Several  variations  to  objects,  such  as  color  and  font,  are  provided  to 

improve  the  readability  of  the  data  flow  diagram.    These  variations  have  no  effect 

on  the  operation  of  the  prototype,  only  on  the  visual  representation  of  the  data  flow 

diagram. 

a.         Symbols 

The  data  flow  diagram  consists  of  a  network  of  operators,  connected 
through  streams.  Operators  and  streams  are  the  only  objects  which  are  represented 
in  the  data  flow  diagram.  Figure  42  depicts  all  of  the  symbols  which  are  available  to 
the  user. 

Chapter  II  introduced  the  distinction  between  operators  which  are  con- 
sidered to  be  part  of  the  prototype  system  and  those  which  reside  outside  the  system. 
Those  operators  which  reside  outside  the  prototype  system  partition  were  specified 
by  assigning  a  maximum  execution  time  of  zero  and  were  called  Terminators.  Within 
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the  PSDL  Editor,  Terminators  are  symbolized  by  rectangles.  All  other  operators  are 
symbolized  by  circles.  Each  PSDL  Operator,  including  Terminators,  can  be  imple- 
mented either  as  a  composite  operator  or  as  an  atomic  operator.  Atomic  operators 
being  implemented  using  a  PSDL  supported  programming  language,  composite  oper- 
ators being  implemented  themselves  by  a  network  of  PSDL  operators.  All  composite 
operators  are  designated  by  a  double  boarder  in  the  PSDL  Editor,  a  double  rectangle 
for  composite  terminators  and  a  double  circle  for  composite  operators.  In  addition 
to  the  operator  symbol,  the  data  flow  diagram  is  annotated  with  the  operator  name 
and  the  maximum  execution  time,  as  available. 

Chapter  II  also  introduced  the  distinction  between  streams  and  state 
streams.  Streams  are  symbolized  by  a  directed  line,  state  streams  by  a  wider  directed 
line.  In  both  cases,  the  direction  of  information  flow  is  indicated  by  the  arrow. 
Streams  and  state  streams  are  again  annotated  with  the  stream  name  along  with  any 
latency  value,  as  available. 

The  bottom  of  Figure  42  depicts  the  implementation  of  a  composite 

operator.    Streams  into  and  out  of  a  composite  operator  become  external  streams 

within  the  composite  operator's  implementation.  Such  streams  are  designated  with 

a  source  or  destination  of  External.  Once  again,  the  direction  of  information  flow  is 

indicated  by  the  arrow. 

b.         Drawing 

The  data  flow  diagram  is  created  by  selecting  a  drawing  tool  from  the 

Tool  Bar  and  positioning  the  object  in  the  Drawing  Window.  The  drawing  tool, 

once  selected,  remains  selected  until  another  drawing  tool  is  picked  by  the  user.  This 

allows  the  user  to  position  as  many  copies  of  that  object  in  the  Drawing  Window  as 

desired.  Specifically,  the  following  procedures  are  used  create  the  data  flow  diagram. 

•Operators  are  added  by  first  depressing  and  releasing  the  left-mouse  button 
over  the  desired  Operator/Terminator  Tool  to  select  the  tool.  Then, 
positioning  the  cursor  over  the  desired  operator/terminator  location  and  de- 
pressing and  releasing  the  left-mouse  button.  Repeat  for  additional  opera- 
tors/terminators. 
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Figure  43.  Construction  of  a  Stream 


►Streams  are  added  by  first  depressing  and  releasing  the  left-mouse  button  over 
the  Stream  Tool  to  select  the  tool.  Streams,  unlike  operators,  are  created 
with  a  sequence  of  points.  At  least  two  points  are  required  to  establish  a  source 
and  destination.  Other  points  can  be  added  to  route  the  stream  around  other 
objects  on  the  Drawing  Window.  The  stream  source  is  always  the  first 
point  selected.  The  stream  destination  is  always  the  last  point  selected.  Start 
the  stream  by  positioning  the  cursor  over  the  source  operator  and  depressing 
and  releasing  the  left-mouse  button.  Streams  start  and  finish  at  the  middle 
of  an  operator.  There  is  no  need  to  precisely  position  the  cursor  when  se- 
lecting the  source  or  destination.  Route  the  stream  using  intermediate  points 
by  depressing  and  releasing  the  left-mouse  button  over  each  location.  As  the 
stream  is  built,  it  is  represented  with  dashed  line  segments  between  anchor 
points.  Anchor  points  are  represented  as  small  black  squares,  indicating  an 
intermediate  point.  A  stream  under  construction  is  depicted  in  Figure  43. 
The  stream  is  finalized  by  positioning  the  cursor  over  the  destination  operator 
and  depressing  and  releasing  the  left-mouse  button.  The  resulting  stream  is  a 
smooth  curved  line  with  an  arrow  at  the  destination,  as  depicted  in  Figure  44. 
There  is  no  requirement  to  provide  intermediate  points  within  a  stream.  How- 
ever, the  PSDL  Editor  does  not  provide  for  the  addition  of  intermediate  points 
to  a  completed  stream.  Instead,  the  stream  must  be  deleted  and  replaced.  It 
is  recommended  that  streams  incorporate  at  least  one  intermediate  point  to 
provide  for  future  routing  changes. 

•For  composite  operators,  other  than  the  root  operator,  inputs  and  outputs 
of  the  composite  operator  are  represented  as  externals  within  the  data  flow 
diagram.  External  streams  are  similar  to  the  streams  above,  except  that  they 
are  missing  either  a  source  or  destination  operator.  For  an  external  source, 
position  the  cursor  over  the  desired  "source"  location  and  depress  and  release 
the  left-mouse  button.   Continue  the  stream  as  discussed  above.    For  an  ex- 
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Figure  44.  Completed  Stream 


ternal  destination,  start  the  stream  as  discussed  above.  In  order  to  complete 
the  stream,  position  the  cursor  over  the  desired  "destination"  location  and 
double-depress  and  release  the  left-mouse  button.  Care  must  be  taken  that 
the  mouse  does  not  move  during  the  double  button  press.  Otherwise,  addi- 
tional intermediate  points  will  be  created.  The  completed  external  stream  is 
as  represented  in  Figure  42. 

•It  the  user  chooses  to  abort  a  stream  while  in  the  construction  process,  the 
Escape  (Esc)  can  be  used  to  cancel  a  stream  up  until  completion. 

•Stream  and  operator  labels  can  be  added  directly  from  the  Drawing  Win- 
dow. Position  the  cursor  over  the  object  which  is  to  be  labeled.  Once  over 
the  object,  the  left  pointer  cursor  will  be  replaced  with  an  I-Bar  cursor.  At 
this  point,  the  user. can  type  the  label.  The  label  must  correspond  to  a  valid 
identifier  for  the  object.  If  the  cursor  is  moved  during  the  process  of  typing 
the  label,  the  PSDL  Editor  will  assume  that  you  are  restarting  the  label  and 
erase  the  what  has  been  entered. 

•At  any  time,  depressing  and  releasing  the  right-mouse  button  over  an  object 
will  access  the  appropriate  pop-up  window.  After  entering  the  desired  data 
into  the  pop-up  window,  depress  the  OK  to  accept  the  data. 

•In  order  to  create  a  composite  operator,  the  operator  must  first  be  selected. 
This  is  accomplished  by  positioning  the  cursor  over  the  SELECT  TOOL  and 
depressing  and  releasing  the  left-mouse  button.  Next,  position  the  cursor  over 
the  desired  operator  and  depress  and  release  the  left-mouse  button  to  select. 
The  data  flow  diagram  for  the  composite  operator  can  then  be  accessed  by 
selecting  the  Decompose  option  from  the  PSDL  Menu. 

•Several  of  the  PSDL  Editor  functions  require  the  selection  of  an  object.  An 
object  is  selected  through  the  use  of  the  Select  Tool,  which  is  activated  by 
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Figure  45.  Selected  Operator 


depressing  and  releasing  the  left-mouse  button  while  the  cursor  is  located  over 
the  Select  Tool.  Objects  can  then  be  selected  by  locating  the  cursor  over 
the  desired  object  and  depressing  and  releasing  the  left-mouse  button.  As  an 
indication  that  an  object  has  been  selected,  the  anchor  points  for  that  object 
are  displayed,  as  illustrated  in  Figure  45. 

•In  order  to  deselect  an  object,  depress  and  release  the  left-mouse  button  over 
any  white  space  in  the  Drawing  Window. 

•Both  operators  and  streams  can  be  deleted  from  the  data  flow  diagram.  The 
procedure  is  the  same  for  both  operators  and  streams.  Using  the  selection 
procedure  described  above,  select  the  desired  object.  The  object  can  then  be 
deleted  by  the  Delete  key  from  the  keyboard.  If  an  operator  is  deleted,  then 
all  associated  streams  will  also  be  deleted.  If  a  stream  is  deleted,  only  that 
stream  will  be  deleted. 

•The  PSDL  Editor  provides  the  facility  to  undelete  an  operator.  The  undelete 
operator  feature  is  selected  from  the  Edit  Menu.  Selecting  this  feature  access 
a  pop-up  window  which  contains  the  names  of  all  deleted  operators.  Undelete 
the  desired  operator  by  locating  the  cursor  over  the  operator  name  and  double- 
depress  the  left-mouse  button.  This  operation  can  be  somewhat  confusing  in 
the  event  that  un-named  operators  are  deleted.  Such  operators  show  up  in 
the  names  of  deleted  operators  as  a  blank  lines.  However,  the  same  procedure 
still  applies.  When  an  operator  is  recovered,  all  associated  streams  are  also  re- 
covered. Recovery  of  deleted  operators  is  available  from  the  time  the  operator 
is  deleted  up  until  the  time  that  the  graph  editor  passes  control  back  to  the 
background  checker.  Once  control  is  passed  back  to  the  background  checker, 
all  deleted  operators  are  purged.  If  deleted  operators  are  being  maintained  by 
the  PSDL  Editor  when  control  is  passed  back  to  the  background  checker,  the 
user  is  required  to  acknowledge  that  the  deleted  operators,  together  with  the 
corresponding  portions  of  the  hierarchical  tree  which  resides  under  the  deleted 
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operators,  will  be  purged.   The  user  can  select  OK  to  purge  or  the  user  can 
remain  in  the  graph  editor  by  selecting  No  or  Cancel. 

•The  PSDL  Editor  also  provides  the  facility  to  abandon  all  the  changes  made  to 
the  PSDL  operator  since  the  last  time  the  operator  was  synchronized  with  the 
prototype.  This  feature  is  accessed  under  the  Edit  Menu  with  the  Abandon 
Changes  option. 

c.  Graph  Modifications 

Once  the  data  flow  diagram  has  been  defined,  there  are  several  aspects 
of  the  diagram  which  can  be  modified  to  improve  the  readability  of  the  diagram. 
These  changes  have  no  effect  on  the  performance  of  the  prototype,  only  on  the  visual 
representation  of  the  data  flow  diagram. 

•Operators  can  be  moved  within  the  Drawing  Window.  The  movement  of 
graphics  objects  can  only  be  accomplished  when  the  Select  Tool  is  active, 
as  described  in  the  previous  section.  Using  the  Select  Tool,  position  the 
cursor  over  the  desired  operator.  Depress  and  hold  the  left-mouse  button. 
With  the  left-mouse  button  held,  move  the  cursor  to  the  desired  location  and 
release  the  left-mouse  button.  Labels  will  be  moved  with  respect  to  the  new 
operator  location.  Streams  paths  will  be  altered  as  one  of  the  end  points  is 
relocated  with  the  operator.  None  of  the  intermediate  anchor  points  associated 
with  a  stream  are  moved. 

•Streams  paths  can  also  be  changed  in  a  similar  manner.  Select  the  desired 
stream,  as  previously  described,  to  access  the  stream  anchor  points.  Still 
using  the  Stream  Tool,  position  the  cursor  over  the  desired  anchor  point 
and  depress  and  hold  the  left-mouse  button.  With  the  left-mouse  button  held, 
move  the  cursor  to  the  desired  location  and  release  the  left-mouse  button.  The 
location  of  stream  labels  will  be  effected  by  the  new  location  of  the  stream 
mid-point. 

•The  size  of  an  operator  can  likewise  be  changed  through  the  use  of  anchor 
points.  Select  the  desired  operator  using  the  Select  Tool.  Position  the 
cursor  over  the  anchor  point,  which  is  in  the  direction  in  which  you  wish  to 
change  the  operator's  size,  and  depress  and  hold  the  left-mouse  button.  With 
the  left-mouse  button  held,  move  the  cursor  to  the  desired  location  and  release 
the  left-mouse  button. 

•All  labels,  both  names  and  time  values,  can  be  relocated  on  the  Drawing 
Window.  The  label  must  be  selected  as  previously  discussed.  Depress  and 
hold  the  left-mouse  button  with  the  cursor  over  the  desired  label.  Position  the 
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Figure  46.  Relocating  Operator  Label 


cursor  over  the  desired  location  and  release  the  left-mouse  button,  as  depicted 
in  Figure  46. 

•If,  in  attempting  to  reposition  a  stream  intermediate  point  or  an  operator,  one 
of  the  associated  labels  is  moved  instead,  make  sure  that  the  label  is  deselected 
prior  to  attempting  to  move  the  cursor.  This  may  involve  deselecting  and 
reselecting  the  object. 

•As  an  aid  to  increase  the  readability  of  the  data  flow  diagram,  operators  can 
be  colored.  Selecting  Color  from  the  Edit  Menu  access  a  color  pop-up 
window.  This  function  can  be  utilized  in  two  ways.  First,  the  color  of  a 
specific  operator  can  be  changed  by  selecting  the  desired  operator  and  then 
assigning  a  color  from  the  color  pop-up  window.  Second,  the  color  to  be  used 
for  future  operators  can  be  defined  by  deselecting  all  operators  before  accessing 
the  color  pop-up  window  and  then  selecting  a  color. 

•Fonts  can  likewise  be  changed  from  the  Font  option  of  the  Edit  Menu. 
Selecting  the  Font  menu  option  access  a  font  pop-up  window  very  similar 
to  the  color  pop-up  window.  The  same  two  methods  of  operation  for  COLOR 
apply  to  Font.  First,  the  font  of  a  specific  label  can  be  changed  by  selecting 
the  label  prior  to  accessing  the  font  pop-up  window.  Second,  the  font  to  be 
used  for  future  labels  can  be  defined  by  deselecting  all  objects  before  accessing 
the  font  pop-up  window  and  then  selecting  a  font.  Note  that  this  second  mode 
of  operation  can  not  be  used  to  change  the  font  of  an  existing  label  by  typing 
over  the  label  with  a  new  font.  Instead,  the  font  must  be  changed  using  the 
first  method  of  operation. 
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Figure  47.  Printer  Pop-up  Window 

d.         Printing  the  Data  Flow  Diagram 

The  current  data  flow  diagram  can  be  saved  as  an  output  image.  This 
capability  is  accessed  through  the  Print  option  of  the  File  Menu,  which  presents 
a  printer  pop-up  window  (reference  Figure  47).  From  the  printer  pop-up  window, 
the  image  can  be  saved  either  to  the  printer  or  a  file.  If  file  is  selected,  the  user  can 
provide  an  optional  printer  name.  Only  the  printer  name  should  be  provided  in  the 
data  window.  If  no  printer  name  is  provided,  the  image  is  printed  to  the  standard  lpr 
printer.  The  printer  must  be  a  PostScript26  printer.  If  an  output  file  is  selected,  the 
data  flow  diagram  is  saved  to  a  file  using  xwd,  which  produces  an  X  Window  System 
Dump  File  format.  The  file  name  must  be  provided. 

3.       Navigation 

The  graph  editor  is  only  capable  of  displaying/editing  the  data  flow  diagram  of 
one  PSDL  operator  at  a  time.  Each  prototype  consists  of  a  hierarchical  tree  of  PSDL 
operators.  The  PSDL  Editor  provides  facilities  to  traverse  the  hierarchical  tree  in 
order  that  the  entire  prototype  can  be  viewed/edited.  The  mechanism  to  traverse  the 
prototype  is  provided  within  the  PSDL  Menu.  The  options  Decompose  and  Go 
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TO  Parent  are  used  to  traverse  up  and  down  the  hierarchical  tree.  Which  branch  of 
the  tree  is  traversed,  when  going  "down"  the  tree,  is  controlled  by  the  operator  which 
is  selected  in  the  data  flow  diagram.  There  is  only  one  parent,  and  thus  no  option 
when  traveling  "up"  the  tree.  A  short  cut,  Go  TO  Root,  is  provided  to  directly 
traverse  to  the  root  operator.  All  navigation  menu  items  are  equipped  with  a  hot  key 
to  improve  efficiency.  Hot  keys  were  identified  in  Table  XIV. 

4.       File  Operations 

The  PSDL  Editor  provides  very  simple  file  operations.  Since  the  PSDL  Editor 
is  designed  to  work  within  the  CAPS  environment,  there  are  no  provisions  for  creating 
a  new  prototype  or  saving  the  current  prototype  under  a  different  name.  The  PSDL 
Editor  provides  two  basic  functions,  which  are  located  under  the  File  Menu:  Save 
and  Restore  From  Save.  A  short  cut  button,  labeled  SAVE  REQUIRED,  is 
provided  on  the  Status  Bar.  This  button  is  context  sensitive  to  the  status  of  the 
prototype.  If  the  prototype  has  not  been  modified,  the  button  is  labeled  Save  Not 
Required.  Save  does  just  that,  saves  the  prototype  to  disk.  Restore  From  Save 
abandons  all  changes  made  to  the  prototype  since  the  last  save  operation  and  reverts 
back  to  the  last  saved  version.  The  user  will  be  required  to  acknowledge  that  all 
changes  will  be  lost.  Upon  completion  of  the  restore  operation,  the  user  is  returned 
to  the  root  operator.  The  save  operation  will  return  the  user  to  the  original  PSDL 
operator. 

The  user  exits  the  editor  from  the  File  Menu  using  the  Exit  option.  If 
required,  the  user  will  be  prompted  to  save  the  prototype.  In  addition,  the  user  will 
be  informed  that  all  deleted  operators  will  be  purged. 

Instead  of  abandoning  all  changes  made  to  the  prototype  since  the  last  save 
command,  the  user  can  abandon  the  changes  made  to  an  operator  since  the  last  time 
the  operator  was  synchronized  with  the  prototype.  The  Abandon  Changes  option 
is  available  under  the  Edit  Menu  for  this  purpose. 
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Figure  48.  Graph  Editor  Detected  Error 

5.       Syntax/ Semantics  Checking 

Syntax  and  semantic  validation  tests  are  distributed  throughout  the  PSDL 
Editor.  Most  syntax  errors  and  and  a  few  semantic  errors  are  detected  by  the  graph 
editor.  The  graph  editor  performs  syntax  and  semantic  validation  upon  entry  of 
each  data  object,  typically  before  the  data  object  is  written  to  the  editor's  internal 
representation  of  the  prototype.  Errors  detected  by  the  graph  editor  are  reported  with 
an  information  pop-up  window,  which  must  be  acknowledged.  An  error  indication  is 
also  provided  in  the  Status  Message  Window,  reference  Component  9  in  Figure  32, 
which  serves  as  a  reminder  after  the  pop- up  window  has  been  acknowledged. 

Figure  48  is  an  example  of  an  error  detected  by  the  graph  editor.  In  this 
example,  the  operator  name  op_a  is  being  reused  for  the  new  operator  in  the  same 
data  flow  diagram.  Since  op_a  has  already  been  used  within  the  composite  operator, 
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Table  XVI.  Invoking  Syntax/Semantic  Validation 

Check  Syntax  button  from  Status  Bar 
SAVE  REQUIRED  button  from  Status  Bar 
Save  option  from  File  Menu 
Restore  From  Save  option  from  File  Menu 
Syntax  Check  option  from  PSDL  Menu 
Abandon  Changes  option  from  Edit  Menu 


an  error  message  is  generated.  Upon  acknowledging  the  pop-up  notice,  the  Status 
Message  Window  will  be  retained  until  the  next  user  operation.  In  this  instance, 
the  PSDL  Editor  automatically  removes  the  duplicate  name  from  the  operator,  in 
order  to  maintain  a  valid  PSDL  prototype.  Had  the  error  occurred  during  entry  of 
the  operator  name  from  the  Operator  Property  pop-up  window,  the  invalid  operator 
name  would  not  have  been  removed.  Since  changes  to  the  operator  from  the  Operator 
Property  pop-up  window  will  not  be  accepted  until  all  errors  have  ben  resolved,  the 
name  is  retained  so  that  the  user  can  correct  the  error. 

Other  validation  checks  can  only  be  performed  from  a  global  perspective. 
These  errors  can  only  be  detected  by  the  background  checker.  While  the  graph 
editor  performs  validation  upon  data  entry,  the  background  checker  can  only  vali- 
date the  prototype  when  the  prototype  is  synchronized  with  the  graph  editor  and  the 

background  checker  is  passed  control. 

a.  Invoking  Syntax/ Semantic  Validation 

Syntax  and  semantic  validation  by  the  background  checker  is  performed 
whenever  possible.  In  order  to  improve  the  responsiveness  of  the  PSDL  Editor,  valida- 
tion is  not  performed  every  time  that  the  editor  is  synchronized.  Table  XVI  identifies 

all  user  action  which  invokes  the  background  checker  to  perform  validation  checks. 

b.  Error  Messages 

Upon  returning  command  to  the  graph  editor,  any  errors  detected  by 
the  background  checker  will  result  in  the  Check  Syntax  button  being  replaced  with 
the  ERROR  MSGS  button  on  the  Status  Bar.  By  selecting  this  button,  an  Error 
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Messages  pop-up  window  will  be  presented,  as  depicted  in  Figure  27.  Within  the 
Error  Messages  pop-up  window,  the  user  can  select  an  error  message  and  directly 
go  to  one  of  two  operators  associated  with  the  error.  The  Current  operator  is  the 
operator  in  which  the  background  checker  detected  the  error.  The  Parent  operator  is 
relative  to  the  operator  in  which  the  error  was  detected. 

6.       PSDL  Output 

The  output  of  the  PSDL  Editor  is  the  PSDL  code,  which  implements  the 
prototype.  An  example  of  PSDL  code  is  provided  in  Appendix  B.  Identifiers  in 
the  PSDL  code  differ  from  those  observed  in  the  PSDL  Editor,  with  the  addition  of 
suffixes  in  the  PSDL  code.  Hard  copies  of  an  operator's  data  flow  diagram  can  be 
obtained  from  the  PSDL  Editor  through  the  use  of  the  Print  function  under  the 
File  Menu  (reference  Figure  31). 
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V.         IMPLEMENTATION 

The  PSDL  Editor  has  been  a  team  effort.  The  architecture  of  having  two 
programs  (i.e.,  the  background  checker  and  the  graph  editor)  work  together  to  provide 
an  integrated  editor  facility  immediately  lends  itself  to  a  team  development.  Professor 
Man-Tak  Shing  was  responsible  for  this  version  of  the  background  checker.  The 
focus  of  this  research  has  been  the  graph  editor  along  with  the  integration  of  the 
two  programs.  Reference  Appendix  D  for  a  listing  of  the  complete  graph  editor 
source  code.  The  source  code  for  the  background  checker  is  not  available  in  this 
document.  However,  it  is  available  from  the  CAPS  Research  Team  at  the  Naval 
Postgraduate  School,  Computer  Science  department.  Appendix  E  provides  guidelines 
for  the  installation  of  the  PSDL  Editor. 

A.      ARCHITECTURE  OVERVIEW 

The  PSDL  Editor  architecture  is  characterized  as  having  two  programs,  exe- 
cuted in  separate  processes,  which  share  information  through  interprocess  channels. 
The  background  checker  provides  the  facilities  for  all  file  processing,  input  parsing  of 
a  PSDL  prototype,  syntax  and  semantic  validation  of  the  prototype,  and  PSDL  code 
generation.  The  graph  editor  provides  a  graphical  user  interface  and  facilitates  the 
viewing  and  editing  of  the  PSDL  prototype.  Localized  syntax  and  semantic  validation 
is  also  performed  by  the  graph  editor. 

1.        Program  Evolution 

The  current  architecture  of  the  PSDL  Editor  is  the  result  of  an  evolution 
process.  The  CAPS  Release  1  PSDL  Editor  was  the  baseline  from  which  this  research 
was  initiated.  Much  of  the  new  design  is  the  creation  of  Professor  Man-Tak  Shing, 
who  utilized  the  PSDL  Editor  as  the  class  project  in  re-engineering  of  a  software 
engineering  tool.  The  results  of  this  class  project  were  then  expanded  upon  to  produce 
this  research  effort. 
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a.         CAPS  Release  1  PSDL  Editor 

The  CAPS  Release  1  PSDL  Editor  was  developed  by  Captain  Robert 
Dixon,  USMC  [Ref.  13].  Captain  Dixon's  version  of  the  editor  was  implemented 
as  two  programs,  the  syntax-directed  editor  and  the  graph  editor.  Data  was  shared 
between  the  two  programs  using  two  files.  Figure  49  illustrates  the  architecture  used 
to  implement  the  PSDL  Editor.  The  two  files  supported  the  limited  data  sharing 
required  for  the  data  flow  diagram.  The  first  file,  gedatatransf  ile .  txt,  was  used  to 
import  the  data  flow  diagram  into  the  graph  editor  as  well  as  to  make  intermediate 
saves.  The  second  file,  gedatatransfile2.txt,  was  used  to  export  the  data  flow 
diagram  back  to  the  syntax-directed  editor.  A  special  file,  gedatatransf  ile.  lock, 
was  used  to  protect  the  files  in  case  multiple  copies  of  the  PSDL  Editor  were  executed 
in  the  same  directory  space. 

Within  the  graph  editor,  the  C++  class  GraphObjectList  was  used 
to  represent  the  data  flow  diagram.  Captain  Dixon's  thesis  [Ref.  13],  describes  the 
class  structure  used  by  the  graph  editor.  The  data  flow  diagram  itself  is  represented 
as  a  linked  list  of  operator  and  stream  objects.  The  common  features  of  both  of 
these  objects  are  grouped  together  in  the  base  class  GraphObject,  from  which  the 
Operator/Object  and  StreamObject  classes  are  derived.  This  class  structure  is  de- 
picted inside  the  graph  editor  process  of  Figure  49. 

Upon  execution  of  the  graph  editor,  the  representation  of  the  data 
flow  diagram  was  read  from  gedatatransfile.txt  into  the  GraphObjectList  data 
structure  by  build_from_disk().  Upon  returning  to  the  syntax-directed  editor, 
write_to_disk()  was  used  to  write  the  GraphObjectList  data  structure  into  the 
file  gedatatransfile2.txt,  to  be  read  by  the  syntax-directed  editor. 

A  command  line  argument  was  used  by  the  syntax-directed  editor  to 
indicate  if  the  graph  editor  was  to  be  executed  as  a  data  flow  diagram  viewer  or  an 
editor.  The  same  program  was  used  for  both  applications. 

Most  of  the  code  used  to  facilitate  the  data  flow  diagram  was  used 
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Figure  49.  CAPS  Release  1  PSDL  Editor  Architecture 
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directly  to  support  this  research  effort.    Enhancements  were  made  to  provide  for 

the  direct  entry  of  operator  and  stream  labels.    In  addition,  an  abort  was  added 

to  the  stream  creation  process.  The  two  files  used  to  share  information  between  the 

syntax-directed  editor  and  the  graph  editor  were  eliminated,  along  with  the  associated 

methods  which  supported  the  reading  and  writing  of  data  to  these  files.   The  class 

structure  was  maintained.  Additional  fields  and  methods  were  added  to  the  classes 

in  order  to  support  the  full  specification  of  a  PSDL  operator. 
b.  CS4520  Class  Project 

Professor  Man-Tak  Shing  introduced  the  PSDL  Editor  as  the  class 
project  for  the  Naval  Postgraduate  School  course  CS4520  (AY96Q4).  CS4520  is 
a  topical  software  engineering  class.  This  particular  class  dealt  with  software  re- 
engineering.  The  goal  of  the  class  project  was  to  re-engineer  the  PSDL  Editor  to 
provide  a  more  user-friendly  editing  facility.  Only  the  graph  editor  was  evaluated  as 
part  of  the  class  project. 

In  addition  to  implementing  a  new  user  interface,  the  new  graph  editor 
was  to  be  implemented  as  a  C++  function.  All  data  to  be  shared  between  the  back- 
ground checker  and  the  graph  editor  was  to  be  passed  as  arguments  in  the  function 
call.  Although  only  the  graph  editor  was  being  implemented,  the  new  graph  editor 
was  to  be  integrated  with  the  syntax-directed  editor  in  a  single  process. 

The  interface  which  was  used  to  pass  data  between  the  background 
checker  and  the  graph  editor  was  defined  by  ge_interf  ace .  h.  Data  structures  defined 
in  ge.interface.h  expanded  upon  the  data  transfered  by  gedatatransfile.txt, 
used  in  the  CAPS  Release  1  PSDL  Editor.  Within  the  graph  editor,  the  original 
GraphObjectList  class  structure  was  maintained.  Methods  were  developed  to  trans- 
fer data  between  the  ge_interf  ace  .h  data  structures  and  the  GraphObjectList  class 
structure.  These  methods  replaced  the  build_from_disk()  and  write_to_disk() 
methods  used  in  CAPS  Release  1. 

Upon  completion  of  the  CS4520  class  projects,  Professors  Valdis  Berzins 
and  Man-Tak  Shing  reviewed  all  the  projects.  The  project  produced  by  Mr.  Douglas 
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Lange  and  Mr.  Dagohoy  Anunciado  was  chosen  to  be  used  for  continued  research  of 

the  CAPS  PSDL  Editor. 

c.  Thesis  Research 

Picking  up  from  the  work  initiated  by  Mr.  Douglas  Lange  and  Mr. 
Dagohoy  Anunciado,  the  completion  of  the  graphical  user  interface  was  accomplished 
for  the  graph  editor,  along  with  implementing  addition  features.  Initially,  all  work 
on  the  graph  editor  was  accomplished  in  a  stand-alone  fashion,  using  a  simulated 
background  checker  driver  program.  Later,  the  graph  editor  was  integrated  with 
the  background  checker.  The  background  checker  was  created  by  Professor  Man-Tak 
Shing,  using  the  Synthesizer  Generator.  The  result  was  an  Ada/C  program,  which 
was  used  to  call  the  C++  routine  that  was  the  graph  editor. 

Figure  50  provides  a  visualization  of  the  PSDL  Editor  architecture.  The 
PSDL  Editor  consisted  of  a  single  process.  The  background  checker  would  read  the 
specified  PSDL  prototype  from  a  file  and  parse  the  prototype  into  the  prototype  data 
structure.  The  current  operator  would  be  extracted  from  the  syntax-directed  editor 
data  structure  and  formatted  in  accordance  with  the  ge.interf ace.h  specification. 
This  data  would  be  passed  as  arguments  to  the  graph  editor  function.  Inside  the 
graph  editor  routine,  the  current  operator  was  loaded  from  the  ge_interf  ace.h  data 
structures  into  the  GraphObjectList  class  structure  (as  depicted  inside  the  graph 
editor  process  of  Figure  49).  Upon  exiting  the  graph  editor,  the  process  was  reversed. 
The  GraphObjectList  class  structure  was  dumped  into  the  ge_interf ace.h  data 
structures,  which  were  dumped  into  the  prototype  data  structurefor  processing. 

While  development  of  the  graph  editor  continued,  testing  was  con- 
ducted as  an  integrated  unit.  X  Window  System  problems  were  encountered  while 
executing  the  background  checker  and  the  graph  editor  within  a  single  process.  These 
problems  were  not  observed  while  executing  the  graph  editor  with  a  simulated  back- 
ground checker  driver  program. 

Additional  complications  were  encountered  while  troubleshooting  the 
system.    With  the  background  checker  being  implemented  in  Ada  and  C  and  the 
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Figure  50.  Initial  PSDL  Editor  Architecture 
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graph  editor  being  implemented  in  C++,  difficulties  were  encounter  using  the  source 
debuggers.  Finally,  errors  reported  within  the  X  Window  System  routines  could  not 
be  traced  since  there  was  no  source  code  for  the  X  Window  System.  This  configuration 
resulted  in  difficulty  troubleshooting  all  problems  with  the  editor,  typically  using 
output  statements  to  debug  the  program. 

These  problems  were  resolved  by  once  again  splitting  the  PSDL  Editor 
into  two  segments,  the  background  checker  and  the  graph  editor,  executed  in  two 
separate  processes.  This  configuration  also  supported  the  source  debuggers,  which 
were  a  great  aid  to  the  development  of  the  PSDL  Editor. 

Figure  51  provides  a  visualization  of  the  final  PSDL  Editor  architecture, 
in  which  the  graph  editor  is  executed  in  a  separate  process.  The  background  checker  is 
responsible  for  forking  a  child  process  and  establishing  the  pipe  lines  for  interprocess 
communication.  Within  the  background  checker,  the  graph  editor  routine  has  been 
replaced  with  calls  to  transfer  the  ge_interf  ace  .h  data  structures  to  the  graph  editor 
process.  A  driver  ge_driver.C  routine  was  added  to  the  front  of  the  graph  editor. 
This  routine  is  responsible  for  accepting  the  ge.interface.h  data  structures  over 
the  interprocess  communication  pipe  line  and  passing  them  onto  the  graph  editor 
routine.  Upon  exiting  the  graph  editor  routine,  the  ge_driver.C  routine  passes  the 
ge_interface.h  data  structure  back  to  the  background  checker. 

Early  testing  of  the  PSDL  Editor  was  accomplished  using  a  small  pro- 
totype. This  prototype  was  filled  with  PSDL  features,  which  tested  most  of  the  PSDL 
Editor,  however,  it  was  not  a  very  stressful  test.  Later,  additional  testing  was  accom- 
plished using  a  medium  size  prototype.  Upon  testing  with  the  avionics.example 
prototype,  found  in  Appendix  B,  problems  were  encountered.  The  initial  problem, 
which  was  obvious  to  any  user,  was  the  delays  encountered  while  using  the  PSDL 
Editor.  Where  one  of  the  initial  complaints  of  the  CAPS  Release  1  PSDL  Editor  was 
the  delays  between  interacting  with  the  syntax-directed  editor  and  the  graph  editor, 
the  new  implementation  had  even  longer  delays.  Delays  from  30  to  45  seconds  were 
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Figure  51.  Final  PSDL  Editor  Architecture 
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typical  when  navigating  through  the  avionics_example. 

Prolonged  use  of  the  PSDL  Editor  resulted  in  the  second  big  problem, 
the  system  ran  out  of  memory.  In  such  a  case,  the  PSDL  Editor  session  had  to  be 
aborted.  All  unsaved  changes  to  the  prototype  were  lost.  These  problems  are  further 
defined  under  the  Lessons  Learned  paragraph  of  Appendix  B. 

Analysis  of  the  PSDL  Editor  indicated  that  both  the  delay  and  the 
memory  problems  were  due  to  the  background  checker.  These  problems,  as  well  as  the 
desire  to  increase  portability  by  removing  the  reliance  on  the  Synthesizer  Generator, 
resulted  in  the  development  of  the  new  Ada  background  checker. 

2.  Architecture 

The  PSDL  Editor,  in  its  final  configuration,  consists  of  two  segments,  the 
background  checker  and  the  graph  editor.  As  depicted  in  Figure  51,  each  segment 
is  executed  within  its  own  process.  Communication  between  the  two  segments  is 
accomplished  using  Unix  pipes.  Two  pipes  are  opened  to  provide  bi-directional  com- 
munication between  the  two  processes.  Input  to  the  PSDL  Editor  consists  of  a  single 
file  containing  the  PSDL  prototype.  Output  of  the  PSDL  Editor  is  also  a  single  PSDL 
file.  All  user  interaction  is  performed  through  the  graphical  user  interface  provided 
by  the  graph  editor.  The  graphical  user  interface  is  implemented  as  an  X  Window 
System  application  using  the  Motif  widget  set.  Communication  between  the  two 
processes  is  based  upon  the  ge.interface.h  data  structures. 

3.  Data  Communications 

The  interface  between  the  background  checker  and  the  graph  editor  supports 
the  bi-directional  transfer  of  PSDL  data.  In  addition,  errors  detected  by  the  back- 
ground checker  are  transfered  to  the  graph  editor.  While  the  graph  editor  commands 
the  background  checker  to  perform  the  next  action.  All  interprocess  communication 
is  defined  by  the  file  ge_interf  ace  .h.  Along  with  the  data  structures  to  support  the 
above  communications,  ge_interf ace.h  provides  common  definitions. 
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a.  Graph  Description 

The  structure  GRAPH_DESC  provides  all  of  the  information  regarding 
the  prototype  required  by  the  graph  editor.  Only  one  operator  is  processed  by  the 
graph  editor  at  a  time,  although  some  global  prototype  information  is  shared.  The 
GRAPH_DESC  structure  represents  the  operator's  data  flow  diagram  as  a  linked  list  of 
OPERATOR  structures  as  well  as  a  linked  list  of  STREAM  structures.  The  GRAPH_DESC 
structure  is  used  in  bi-directional  communication  with  the  background  checker  and 

the  graph  editor. 

b.  Error  Messages 

Errors  detected  by  the  background  checker  can  only  be  presented  to 
the  user  through  the  graphical  user  interface  provided  by  the  graph  editor.  The  data 
structure  ERROR_MSGS  is  a  linked  list  of  error  messages,  along  with  associated  opera- 
tor and  parent  operator  identification.   If  no  errors  are  detected  by  the  background 

checker,  a  NULL  pointer  shall  be  provided  to  the  graph  editor. 

c.  Next  Action 

The  data  structure  ACTION  provides  the  background  checker  with  the 
commands  required  to  determine  the  next  action  to  take.  Instruction  is  provided  on 
how  to  synchronize  the  data  contained  within  GRAPH_DESC  with  the  prototype  data 
structure,  maintained  by  the  background  checker.  Also  provided  are  instructions  on 
returning  to  the  graph  editor  with  the  desired  current  operator. 

4.        Synchronization 

Within  the  graph  editor,  all  changes  to  an  operator  are  local  to  the  graph 
editor.  Local  changes  are  synchronized  with  the  prototype  maintained  by  the  back- 
ground checker  upon  specific  user  requested  events.  The  synchronization,  along  with 
the  user  specified  event,  were  listed  in  Table  XV  of  Chapter  IV.  All  synchronization  is 
a  function  of  the  background  checker.  A  distinction  was  made  between  UPDATE_TREE 
and  CHECK-SYNTAX  as  a  concession  to  performance.  Initially,  syntax  validation  was 
performed  with  each  synchronization  event.    However,  large  delays  to  perform  syn- 
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Figure  52.  Background  Checker  Synchronization 

tax  validation  made  this  option  unattractive  for  all  synchronization  events.  Thus, 
UPDATE_TREE  was  added  as  an  option,  in  which  the  prototype  data  structure,  main- 
tained by  the  background  checker,  were  synchronized  with  any  modifications  made 
in  the  graph  editor,  but  with  no  syntax  validation.  This  option  was  provided  to  im- 
prover performance  while  navigating  the  prototype.  Figure  52  illustrates  the  type  of 
processing  which  is  expected  to  be  performed  by  the  background  checker  based  on 
the  synchronization  command. 

B.      GRAPH  EDITOR  DATA  STRUCTURES 

Within  the  graph  editor,  the  GraphObjectList  class  structure  is  used  to  main- 
tain all  PSDL  data.  Captain  Dixon  described  this  structure  in  his  thesis  [Ref.  13]. 
This  class  structure  has  been  maintained  with  this  release  of  the  PSDL  Editor.  A 
class  diagram  of  the  GraphObjectList  structure  was  provided  within  the  graph  editor 
process  box  of  Figure  49. 

All  information  contained  within  GRAPH_DESC,  from  ge.interface.h,  which 
does  not  relate  to  the  data  flow  diagram  was  appended  to  the  GraphObjectList 
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class.  Changes  were  made  to  all  classes  that  incorporated  a  time  literal.  In  the  CAPS 
Release  1  PSDL  Editor,  time  literals  were  encoded  as  signed  integers.  All  time  values 
in  microseconds  were  encoded  as  negative  times.  Values  in  milliseconds  were  encoded 
as  positive  times.  In  order  to  support  all  time  units  defined  in  the  CAPS  Release  2 
PSDL  grammar,  time  literals  were  maintained  with  two  symbols.  One  maintained 
the  time  value,  the  other  maintained  the  time  units. 

Data  flow  diagram  representation  information  was  appended  to  class  objects 
OperatorObject  and  StreamObject  as  applicable.  Label  and  time  values,  displayed 
on  the  data  flow  diagram,  for  both  operators  and  streams  were  modified  to  function  as 
offsets  from  the  graphics  object.  Previously,  labels  and  time  values  were  recorded  at 
absolute  locations.  Methods  were  added  to  support  the  ge_interface.h  structures. 

C.       UTILITIES 

Several  sets  of  utilities  files  were  created  in  the  process  of  developing  the  PSDL 
Editor. 

1.        Graph  Editor  Utilities 

The  files  ge_utilities.h  and  ge_utilities.c  provide  a  set  of  routines  for 
dealing  with  components  of  the  PSDL  Editor.  These  files  were  written  in  C  in  order 
to  support  both  the  graph  editor  as  well  as  the  original  syntax-directed  editor  (which 
was  written  in  C  due  to  the  Synthesizer  Generator).  Primarily,  the  routines  in  these 
files  support  the  maintenance  of  the  data  structures  defined  in  ge_interf  ace  .h.  The 
routine  dup_str()  is  used  throughout  the  PSDL  Editor.  This  routine  is  used  to  make 
a  deep  copy  of  a  string.  In  general,  the  PSDL  Editor  is  implemented  using  deep 
copies.  Shared  values  have  been  avoided. 

Another  facility  provided  by  the  ge -utilities  routines  is  the  validation  of 
PSDL  constructs.  These  routines  are  used  by  the  graph  editor  to  validate  identifiers, 
operator  identifiers,  type  names,  keywords,  and  integer  literals. 
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Table  XVII.  Inter-Process  Communication  Routines 

readActionO  writeActionO 

readErrorMsgsO     writeErrorMsgsO 
readGraphDescO     writeGraphDescO 


2.  Inter-Process  Communication 

The  inter-process  communication  package  was  designed  to  accept  the  data 
structures  defined  by  ge.interface.h  at  one  end  and  recreate  the  same  data  struc- 
tures on  the  other  end.  These  communication  facilities  are  provided  by  the  routines 
in  the  files  inter_process_utilities.h  and  inter_process_utilities .c.  Once 
again,  these  files  were  written  in  C  to  support  both  the  background  checker  and  the 
graph  editor. 

The  inter-process  communication  facility  is  provided  by  six  routines  listed  in 
Table  XVII.  These  routines  operate  on  a  xf  er.buf  f  er.  The  xf  er.buf  f  er  is  allowed 
to  expand,  doubling  in  size  each  time,  in  order  to  support  the  largest  data  structure. 
The  xf  er_buf  f  er  itself  is  sent  over  Unix  pipes  in  packets  with  a  maximum  size  of 
4096  bytes. 

The  pipe  lines  used  to  facilitate  inter-process  communications  are  established 
by  the  background  checker  upon  creation  of  the  graph  editor  process.  Two  pipe  lines 
are  opened,  in  order  to  provide  bi-directional  communication.  The  two  channels  to  be 
used  are  passed  to  the  graph  editor  as  command  line  arguments.  The  file  ge -driver .  C 
is  the  mainO  routine  for  the  graph  editor.  This  file  processes  the  command  line 
arguments  containing  the  channel  numbers.  The  code  used  to  open  the  pipe  lines  is 
provided  by  the  background  checker.  A  sample  of  code  used  to  facilitate  this  process 
may  be  found  in  the  file  sde.c,  which  is  discussed  below. 

3.  Unique  Identifier  Generator 

The  incorporation  of  unique  suffixes  for  operators  required  a  unique  suffix 
generator.     The  files  get  .unique  _id.h  and  get_unique_id.c  provide  this  facility. 
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Once  again,  these  files  were  developed  in  C  in  order  to  support  both  the  graph  editor 
and  the  background  checker.  This  implementation  uses  a  file  named  unique_id.dat 
from  which  to  generate  sequential  integers.  Future  releases  of  the  PSDL  Editor  shall 
utilize  a  data  base  to  provide  unique  identifiers  across  a  distributed  development 
environment  (reference  Professor  Berzins'  memo  included  as  Attachment  C).  The 
current  implementation  is  limited  to  the  visibility  of  the  unique_id.data  file. 

4.       Program  Development  Aids 

Several  files  used  develop  the  PSDL  Editor  have  been  included  within  the 
source  code  for  the  graph  editor.    While  not  required  for  operation  of  the  PSDL 

Editor,  they  may  be  useful  for  future  development  efforts. 

a.  Driver  Program 

The  files  sde.c,  sde.simulator  .h,  and  sde -simulator .c  were  devel- 
oped to  perform  stand  alone  testing  of  the  graph  editor.  The  file  sde .  c  provides 
the  mainO  routine  used  to  fork  the  graph  editor  in  its  own  process  as  well  as  to 
establish  communications.  The  sde_simulator  files  provide  a  hard-coded  prototype 
which  can  be  edited.  Note  that  this  driver  program  has  not  been  designed  to  work 
interactively  with  the  graph  editor.  The  driver  program  does  not  contain  the  facilities 
to  synchronize  with  the  graph  editor. 

While  the  source  code  for  the  background  checker  is  not  contained  here, 
the  file  sde .  c  does  provide  an  example  of  code  used  to  fork  the  graph  editor  process 

and  to  establish  communication  pipe  lines. 

b.  Debug  Routines 

In  the  process  of  integrating  the  background  checker  and  the  graph  edi- 
tor, often  there  was  a  need  to  examine  the  data  contained  within  the  ge_interf  ace  .h 
data  structures.  A  collection  of  routines  provided  in  files  ge_utilities_debug.h, 
ge _ut i  1  it ies -debug,  c,  and  ge_interface_labels  .h  were  developed  to  display  and 
print  to  a  file  the  contents  of  the  ge.interface.h  data  structures. 
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D.      GRAPH  EDITOR 

The  files  used  to  implement  the  graph  editor,  roughly  organized  by  function, 
are  listed  in  Table  XVIII.  The  graph  editor  routine  which  actually  edits  the  prototype 
is  edit  .graph  ( ) ,  defined  in  graph_edit  or .  C.  This  routine  is  called  from  ge  .driver .  C 
upon  receiving  the  ge_interface.h  data  structure  from  the  background  checker. 
At  every  synchronization  event,  this  routine  is  exited.  Within  edit_graph(),  the 
Motif  windows  are  initialized.  Initialization  is  performed  once,  based  on  the  symbol 
motif -initialized.  After  the  initial  entry,  the  Motif  environment  is  assumed  to 
exist.  Motif  data  is  maintained  within  global  objects  in  order  to  provide  persistence. 

Typically,  a  Motif  application  expects  to  pass  control  over  to  Motif  until  the 
program  terminates.  In  order  to  support  the  PSDL  Editor,  the  Motif  control  loop  had 
to  be  maintained  within  the  graph  editor.  The  edit -graph  ()  routine  enters  a  loop 
which  dispatches  X  Window  System  events  until  a  synchronization  event  is  selected 
by  the  user  to  exit  the  graph  editor. 
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Table  XVIII.  Graph  Editor  Source  Code  Files 


Function 

Header  File 

Code  File 

Graph  Editor 

ge_driver . c 

graph_editor .h 

graph_editor .C 

Definition  Files 

ge_interface.h 
ge.defs.h 
resources. h 

Classes 

graph_object_list .h 

graph_object_list .C 

graph_object .h 

graph_object  .C 

operator_obj  ect . h 

operat or_ob j  ect .  C 

stream_ob j  ect .  h 

stream.object .C 

spline_object .h 

spline_object .C 

font_table.h 

f  ont.table.C 

Pop-up  Windows 

operator_property_menu .  h 

operator_property_menu .  C 

stream_property  _menu .  h 

stream_property_menu .  C 

Window  Utilities 

action_area.h 

action_area.C 

build_option.h 

build_option. c 

gettopshell.h 

gettopshell.c 

postpopup.h 

postpopup.c 

report -errors. h 

report_errors . C 

setcursor .h 

setcursor. c 

timer_tool.h 

timer_tool.C 

warning . h 

warning . C 

windows. h 

windows .C 

Utilities 

ge_utilities.h 

ge_utilities .c 

inter_process_utilities . h 

inter_process_utilities . c 

get_unique_id.h 

get_unique_id.c 
sde.c 

sde_simulator .h 

sde_simulator .c 

ge_utilities_debug.h 

ge_utilities_debug.c 

ge_interf ace_labels .h 
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VI.         CONCLUSIONS  AND 
RECOMMENDATIONS 

Overall,  this  research  was  successful  in  the  development  of  an  improved  PSDL 
Editor  facility.  While  full  graphical  user  interface  support  was  not  provided  for  all 
features  of  PSDL,  sufficient  portions  of  the  language  were  supported  to  demonstrate 
the  concepts  of  the  improved  interface. 

Since  the  aspects  of  the  PSDL  Editor  addressed  by  this  research  primarily 
relate  to  human  factors,  any  validation  of  the  improvements  made  would  have  to 
be  accomplished  with  a  survey  of  users.  Such  a  survey  was  not  conducted  as  part 
of  this  research,  so  no  conclusions  can  be  stated  regarding  the  effectiveness  of  the 
improvements.  However,  a  few  personal  observations  from  experience  obtained  while 
testing  the  PSDL  Editor  can  be  made  along  with  some  recommendations  for  future 
research. 

A.      RESULTS  OF  RESEARCH 

Based  on  personal  experience  with  the  PSDL  Editor,  I  would  submit  that 
the  artificial  boundary  between  the  syntax-directed  editor  and  the  graph  editor  has 
been  significantly  reduced.  What  remains  of  the  boundary  is  the  batch  mode  of 
operation  when  it  comes  to  global  syntax  and  semantic  validation  as  well  as  any 
delays  encountered  switching  between  the  two  programs.  While  early  versions  of  the 
improved  PSDL  Editor  had  significant  delays,  optimizations  within  the  background 
checker  have  resulted  in  acceptable  delay  times,  even  for  large  prototypes. 

Use  of  pop-up  windows  to  specify  the  details  of  an  operator  or  stream  has 
streamlined  the  development  of  prototypes.  Immediate  access  to  complete  details  of 
a  data  flow  diagram  object  are  now  one  button  away.  No  longer  are  users  compelled 
to  complete  the  data  flow  diagram  prior  to  entering  any  of  the  details,  due  to  the  long 
delays  and  steps  required  to  access  this  data.   Direct  entry  of  operator  and  stream 
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labels  has  been  a  significant  step  in  streamlining  the  development  process. 

Previous  problems  encountered  by  users  attempting  to  locate  a  construct 
within  the  syntax-directed  editor  should  not  be  as  prevalent  with  the  use  of  pop-up 
windows.  These  problems,  associated  with  a  linear  translation  of  the  PSDL  gram- 
mar, are  reduced  by  the  depiction  of  all  options  within  the  pop-up  window.  Options 
displayed  in  the  pop-up  window  are  consistent  with  the  current  configuration  of  the 
object.  No  longer  must  a  user  remember  the  ordering  of  PSDL  constructs,  they  are 
visible  to  the  user  from  the  pop-up  window.  Ghosting  of  an  option  acts  to  remind  the 
user  of  the  availability  of  an  option  while  the  physical  location  of  the  options  suggest 
dependencies  between  options. 

An  improvement  which  should  reduce  the  amount  of  lost  work  in  the  PSDL 
Editor  was  the  simplification  of  file  operations.  All  file  save  operations  now  write 
directly  to  the  prototype  file.  There  is  no  longer  an  intermediate  file  to  which  the 
editor  saves  the  prototype,  from  which  users  have  lost  entire  edit  sessions  due  to 
a  misunderstanding  of  the  save  procedure.  The  currently  implemented  file  system 
should  be  intuitive  to  most  users  of  personnel  computer  software. 

As  previously  mentioned,  not  all  features  of  PSDL  were  implemented  with 
the  graphical  user  interface.  Several  features  of  PSDL  were  determined  to  be  too 
complex  for  this  initial  implementation  of  the  graphical  user  interface.  These  features 
included  abstract  data  types,  constraint  options,  expressions,  and  the  specification 
interface.  Although  not  supported  by  the  graphical  user  interface,  these  features  were 
not  left  unsupported.  Text  windows  were  provided  within  the  graph  editor  for  the 
specification  of  these  constructs  using  PSDL.  Being  some  of  the  more  complex  PSDL 
constructs,  they  are  also  some  of  the  more  advanced  features.  And  while  all  these 
features  are  critical  to  the  use  of  PSDL,  they  are  most  often  used  by  more  advanced 
users.  The  result  is  that  the  PSDL  Editor  provides  sufficient  capabilities  to  be  utilized 
for  prototype  development  by  the  average  user.  More  advanced  users  can  still  utilize 
the  PSDL  Editor,  however,  they  will  require  more  knowledge  of  PSDL  to  access  these 
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advanced  features  of  PSDL. 

B.       CRITIC  OF  RESEARCH 

As  with  any  program,  criticism  can  be  made  of  the  design  and  implementation. 
This  program  offers  no  exception.  Discussed  below  are  observations  of  problems 
in  the  design  and  implementation.  I  do  not  point  a  finger  to  any  previous  author 
of  the  PSDL  Editor  for  problems  with  this  release.  All  of  the  problems,  both  in 
design  and  implementation,  were  mine  to  address.  What  few  problems  were  inherited 
from  previous  authors  were  most  likely  small  problems  which  I  have  amplified  in 
"improving"  the  program.  But  just  as  there  was  insufficient  time  to  support  all 
features  of  PSDL,  there  was  insufficient  time  to  address  these  "features"  of  the  PSDL 
Editor. 

1.        User  Interface 

The  mapping  between  the  PSDL  Editor's  graphical  user  interface  and  PSDL 
is  not  clean.  For  instance,  the  functionality  of  an  operator's  specification  is  accessed 
through  the  pop-up  window  for  a  composite  operator.  This  mapping  does  not  support 
the  root  operator. 

The  drawing  operation  of  the  data  flow  diagram  is  too  slow.  While  there  may 
be  a  tendency  to  coerce  the  user  to  maintain  good  programming  practices  and  keep 
the  data  flow  diagram  simple,  it  should  not  be  accomplished  by  aggravating  the  user 
with  delays.  The  drawing  of  streams,  and  especially  state  streams,  is  extremely  slow. 
The  system  is  not  usable,  when  executed  remotely  over  phone  lines. 

Associated  with  the  delays  involved  with  drawing  the  data  flow  diagram,  the 
data  flow  diagram  is  too  sensitive  to  change.  Unintentional  changes  are  typically 
made  to  the  data  flow  diagram  as  the  user  attempts  to  navigate  the  prototype.  In 
order  to  navigate  through  the  prototype,  the  user  must  select  an  operator.  If  the  user 
moves  the  mouse  while  the  left-mouse  button  is  depressed,  the  object  will  be  moved 
and  the  user  will  have  to  wait  for  the  data  flow  diagram  drawing  to  be  updated. 
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The  pop-up  facilities  to  modify  an  operator's  color  or  a  label's  font  as  well  as 
those  used  to  recover  a  deleted  operator  are  rudimentary.  No  provisions  are  made 
to  indicate  the  currently  selected  color  or  font.  No  provisions  are  made  to  Ok  the 
selection  or  to  cancel  the  operation.  The  user  is  required  to  know  how  to  select  the 
item  with  a  double  mouse  action  as  well  as  the  current  value,  in  case  the  user  wishes 
to  leave  the  value  unchanged.  No  feedback  is  provided  to  the  user  to  indicate  that 
a  color  or  font  change  is  being  performed  on  a  specific  object  or  the  default  value  is 
being  changed.  The  restoration  of  an  unlabeled  operator  is  a  guessing  game  for  the 
user. 

2.       Implementation 

The  PSDL  Editor  started  out  as  two  programs,  executed  in  separate  processes. 
As  an  update  to  the  design,  it  was  converted  over  to  a  single  program,  executed  in 
a  single  process.  Problems  encountered  with  this  configuration  forced  it  to  be  split 
once  more  into  two  programs,  executed  in  separate  processes.  Again,  problems  were 
encountered  which  forced  a  change  to  the  design  of  the  editor.  This  last  change  has 
seen  the  removal  of  the  Synthesizer  Generator  produced  background  checker,  to  be 
replaced  with  an  Ada  version.  With  this  latest  change,  no  modification  was  made 
to  the  interface  between  the  background  checker  and  the  graph  editor.  With  the 
design  changes  which  have  occurred  so  far,  maintaining  two  separate  programs  may 
be  wise.  However,  at  this  point,  two  separate  processes  appears  to  be  unnecessary. 
Associated  with  two  separate  processes  is  a  lot  of  communication  overhead  which 
could  be  removed,  thus  simplifying  the  program.  Combining  the  two  tasks  into  one 
procedure  would  also  improve  the  performance  with  respect  to  delays,  thus  further 
reducing  the  artificial  boundary  between  the  background  checker  and  the  graph  editor. 

With  the  evolution  of  the  graph  editor,  the  program  has  become  "messy".  The 
program  has  appeared  to  have  lost  any  structure  as  new  features  are  simply  added. 
Global  objects  are  used  throughout  the  program  to  provide  communication  with  the 
graphical  user  interface.    Files  have  become  much  too  large.    The  graph_editor.C 
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file,  once  printed,  goes  on  for  fifty  pages.  The  draw  routine  alone  is  ten  pages  long, 
with  far  too  many  levels  of  indentation.  Even  simple  maintenance  to  the  program 
becomes  complex  and  error  prone  with  this  absence  of  organization. 

Within  the  graph  editor,  a  clean  representation  of  data  objects  has  not  been 
maintained.  Redundant  data  is  maintained  throughout  the  data  objects.  For  in- 
stance, which  graphical  object  is  selected  is  indicated  within  the  data  structure  for 
that  object.  Thus  a  house  keeping  process  must  be  maintained  to  ensure  that  only 
one  object  is  selected  at  at  time,  clearing  all  other  selected  objects.  The  result  is  that, 
occasionally,  multiple  graphic  objects  appear  to  be  selected.  The  user  is  confused  at 
this  point.  Only  by  selecting  and  de-selecting  each  object  that  appears  to  be  selected 
can  the  indications  be  cleared  up. 

C.       RECOMMENDATIONS  FOR  FUTURE  RESEARCH 

In  the  process  of  re-engineering  the  PSDL  Editor,  many  additional  ideas  come 
to  mind.  Most  of  which  are  much  too  late  to  be  incorporated  into  the  design  of 
the  system.  The  following  is  a  collection  of  ideas  which  should  be  used  to  stimulate 
thought  for  the  next  release  of  the  PSDL  Editor. 

The  current  design  of  the  graphical  user  interface  provides  a  very  limited  view 
of  the  context  of  an  operator.  The  user  is  presented  with  the  data  flow  diagram  of 
the  operator,  but  no  visualization  of  the  context  of  the  operator.  The  CAPS  Release 
1  PSDL  Editor  provided  some  indication  of  external  streams.  Even  this  limited  view 
of  context  was  removed  from  this  release  of  the  PSDL  Editor.  Future  releases  of 
the  PSDL  Editor  should  prompt  the  user  with  options  available  from  the  operator's 
context.  Figures  53  and  54  depict  an  initial  attempt  to  provide  the  user  with  such  a 
context  with  respect  to  streams.  Figure  53  illustrates  the  user's  options  of  entering  a 
stream  name  directly  into  the  data  entry  window  or  to  select  from  a  list  of  predefined 
streams.  Figure  54  depicts  all  streams  which  are  currently  defined  in  the  context, 
along  with  an  indication  of  external  streams  and  their  use,  state  streams  and  their 
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Figure  53.  Stream  Property  Pop-up  with  Predefined  Option 


Figure  54.  Stream  Predefined  Context 
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initial  value,  and  the  stream  type.  Due  to  scheduling  constraints,  this  option  was 
never  incorporated  into  the  final  release  of  the  PSDL  Editor. 

Options  available  for  improved  data  flow  diagram  editing  capabilities  mostly 
involve  modifications  to  streams.  Such  features  as  being  able  to  remove  or  add  inter- 
mediate stream  anchor  points  as  well  as  being  able  to  change  the  direction  of  a  stream 
would  improve  the  user's  ability  to  modify  an  existing  data  flow  diagram.  Higher  level 
edit  features  for  working  with  operators  would  also  greatly  improve  the  user's  ability 
to  modify  a  prototype.  Such  features  would  include  the  ability  to  select  a  group  of 
operators  from  a  single  data  flow  diagram  and  form  a  composite  operator  from  them, 
thus  adding  one  more  level  to  the  hierarchical  tree.  The  reverse  operation  could  also 
be  provided  as  a  feature,  to  remove  a  level  from  the  hierarchical  tree.  Copy,  cut,  and 
paste  operations  on  selected  operators  could  be  provided.  Modifications  to  object 
properties,  such  as  color  and  font,  could  be  performed  on  several  selected  objects 
simultaneously. 

Improved  semantic  validation  capabilities  could  be  incorporated.  Possible  can- 
didates include  detecting  cycles  in  data  flow  diagrams  which  are  not  broken  by  state 
streams  and  global  validation  of  timing  constraints.  This  release  of  the  PSDL  Editor 
took  a  step  backward  in  editing  an  existing  prototype.  In  order  to  edit  a  prototype, 
the  editor  must  be  able  to  parse  the  input  file.  Syntactical  errors  in  the  input  file 
could  result  in  the  PSDL  Editor  not  being  able  to  parse  the  prototype.  Previously, 
the  PSDL  Editor  would  at  least  allow  the  user  to  edit  the  prototype  text  if  a  syn- 
tactical error  was  detected.  With  this  release,  the  PSDL  Editor  is  not  usable  on  a 
corrupted  prototype. 

While  the  CAPS  environment  provides  access  to  the  complete  set  of  CAPS 
tools,  many  of  these  tools  could  be  integrated  with  the  PSDL  Editor.  Tighter  inte- 
gration of  CAPS  tools  could  provide: 

•Automatic  generation  of  skeleton  files  to  support  atomic  operators.  This  capa- 
bility has  become  a  necessity  with  the  inclusion  of  unique  suffixes  to  operators. 
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•Direct  access  to  an  editor  to  view/edit  an  atomic  operator  implementation. 

•Access  to  the  reuse  library  from  the  PSDL  Edit  based  on  an  operator's  speci- 
fication. 

•A  PSDL  Editor  mode  for  performing  maintenance  on  the  reuse  library. 

•The  ability  to  save  a  prototype  as  a  new  revision  within  the  Evolution  Control 
System. 

•The  ability  to  merge  prototypes. 

•The  ability  to  examine  the  prototype  schedule  from  the  editor.  Computer 
assistance  should  be  provided  on  how  to  modify  the  prototype  in  order  to 
change  the  schedule. 

Finally,  with  the  advances  made  in  internet  and  intranet  technologies  comes 
the  opportunity  to  improve  upon  existing  applications.  The  migration  of  the  PSDL 
Editor's  help  facilities  to  a  hyper-text  mark-up  language  (HTML)  based  system  should 
be  straight  forward.  Such  a  system  would  be  a  great  improvement  over  the  existing 
capability.  The  conversion  of  the  PSDL  Editor  over  to  a  internet/intranet  applica- 
tion would  be  much  more  involved.  However,  the  resulting  facility  would  provide  a 
portable  editor  capable  of  supporting  distributed  prototype  development. 
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APPENDIX  A.  PSDL  GRAMMAR 

The  following  is  the  complete  specification  of  the  Prototype  System  Descrip- 
tion Language  (PSDL)  syntax  in  an  extension  of  Backus-Naur  Form  (BNF)  [Ref. 
14]. 

The  BNF  description  of  PSDL  specifies  the  sequence  of  symbols  which  con- 
stitute a  valid  PSDL  prototype.  BNF  describes  the  language  in  terms  of  production 
rules.  Each  production  rule  equates  a  non-terminal  symbol  to  a  sequence  of  termi- 
nal and  non-terminal  symbols.  Terminal  symbols  are  symbols  which  can  occur  in 
PSDL.  Non-terminal  symbols  are  metalinguistic  variables  whose  value  is  a  sequence 
of  symbols  which  represents  a  PSDL  construct. 

Terminals  are  represented  as  bold  symbols  (e.g.,  operator).  Non-terminals 
are  enclosed  in  angle  brackets,  (  and  )  (e.g.,  (psdl)).  Additional  metasymbols  are 
introduced  in  the  extension  of  BNF  to  reduce  the  number  of  productions  and  non- 
terminals. These  metasymbols  are  defined  as: 

•Square  brackets,  [  ],  enclose  optional  items. 

•Curly  braces,  {  },  enclose  items  which  may  appear  zero  or  more  times. 

•Vertical  bars,  |,  represent  a  choice  between  items. 

•Parentheses,  (  ),  represent  a  grouping  of  items. 

In  some  cases,  the  metasymbols  used  are  also  used  as  terminals  within  PSDL.  In 
order  to  avoid  confusion,  such  terminal  symbols  are  enclosed  within  single  quotes, 

(e.g.,  ')')• 

For  ease  of  reference,  each  production  rule  is  numbered  on  the  left  hand  side. 
These  numbers  are  not  part  of  the  PSDL  syntax. 
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1  (psdl) 

::—     {  (component)  } 

2  (component) 

::=     (data-type) 
(operator) 

3  (data-type) 

::=     type  (id)  (typespec)  (typeJmpl) 

4  (typespec) 

::=     specification  [  generic  (type-decl)  ]  [  (type-decl)  ] 
{  operator  (opjname)  (operator spec)  } 
[  (functionality)  ]  end 

5  (operator) 

::=     operator  (op-name)  (operator spec)  (operator  Jmpl) 

6  (operator  spec) 

::=     specification  {  (interface)  }  [  (functionality)  ]  end 

7  (interface) 

::=     (attribute)  [  (reqmts .trace)  ] 

8  (attribute) 

::=     generic  (type-decl) 
input  (type-decl) 
output  (type-decl) 

states  (type-decl)  initially  (initial -expression -list) 
exceptions  (id-list) 
maximum  execution  time  (time) 

9  (typejdecl) 

::=     (idJist)  :  (type-name)  {  ,  (idJist)  :  (type-name)  } 

10  (type-name) 

::=     (id) 

|    (id)  '['  (type-decl)  ']' 

11  (idJist) 

::=     (id){,(id)} 
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12  (reqmts  Jrace) 

::—     required  by  (idJist) 

13  (functionality) 

::=     [  (keywords)  ]  [  (informaLdesc)  ]  [  (formal jdesc)  ] 

14  (keywords) 

::=     keywords  (idJist) 

15  (informal -desc) 

::=     description  '{'  (text)  '}' 

16  (formal-desc) 

::=     axioms  '{'  (text)  '}' 

17  (typeJmpl) 

::=     implementation  (id)  (id)  end 
implementation  (type-name) 
{  operator  (opjname)  (operator  Jmpl)  }  end 

18  (operator  Jmpl) 

::=     implementation  (id)  (id)  end 
implementation  (psdLimpl)  end 

19  (psdLimpl) 

::=     (data-flow -diagram)  [  (streams)  }  [  (timers)  ] 
[  (control -constraints)  ]  [  (informaLdesc)  ] 

20  (data-flow -diagram) 

::=     graph  {  (vertex)  }  {  (edge)  } 

21  (vertex) 

::=     vertex  (opJd)  [  :  (time)  ]  {  (property)  } 

22  (ed^e) 

::=     edge  (zd)  [  :  (time)  ]  (opJd)  — >  (opJd)  {  (property)  } 

23  (property) 

::=     property  (id)  =  (expression) 

24  (opJd) 

::=     [(id)  .  ]  (op.name)  [  '('  [  (idJist)  ]  T  [  (idJist)  }  ')'  ] 
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25  (streams) 

::=     data  stream  (type-decl) 

26  (timers) 

::—     timer  (idJist) 

27  (control  .constraints) 

::=     control  constraints  (constraint)  {  (constraint)  } 

28  (constraint) 

::=     operator  (op .id) 

[  triggered  [  (trigger)  ]  [  if  (expression)  ]  [  (reqmts -trace)  ] 

[  period  (time)  [  (reqmts -trace)  ] 

[  finish  within  (time)  [  (reqmts -trace)  ] 

[  minimum  calling  period  (time)  [  (reqmts -trace)  ] 

[  maximum  response  time  (time)  [  (reqmts -trace)  ] 

{  (constraint -options)  } 

29  (constraint  .options) 

::=     output  (idJist)  if  (expression)  [  (reqmts -trace)  ] 
exception  (id)  [  if  (expression)  ]  [  (reqmts -trace)  ] 
(timer-op)  (id)  [  if  (expression)  ]  [  (reqmts -trace)  ] 

30  (trigger) 

::=     by  all  (idJist) 
|    by  some  (idJist) 

31  (timer -op) 

::=  reset  timer 
start  timer 
stop  timer 

32  (initial  .expression  Jist) 

::=     (initial -expression)  {  ,  (initial .expression)  } 

33  (initial -expression) 

::=     true 
false 

(integer  Jiteral) 
(real-literal) 
(string -literal) 
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(type-name)  .  (op-name)  [  '('  (initial -expression list)  ')' 
'('  (initial -expression)  ')' 

(initial -expression)  (binary -op)  (initial. expression) 
|    (unary-op)  (initial -expression) 

34  (binary-op) 

::=     and  |  or  |  xor 

|    <  |  >  |  =  |  >=  |  <=  |  /  = 

+  |  —  |  &  |  *  |  /  |  mod  |  rem  |  ** 

35  (unary.op) 

::—     not  |  abs  |  —  |  + 

36  (time) 

::—     (integer literal)  (unit) 

37  (unit) 

::=     microsec 
ms 
sec 
min 
hours 

38  (expressionlist) 

::=     (expression)  {   ,  (expression)   } 

39  (expression) 

::=    true 
false 

(integer  literal) 

(time) 

(real-literal) 

(string  literal) 

(id) 

(type-name)  .  (opjnarne)  [  '('  (expressionlist)  ')' 

'('  (expression)  ')' 

(expression)  (binary-op)  (expression) 

(unary.op)  (expression) 

40  (opjnarne) 

::=     (id) 
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41  (id) 

::=     (letter)  {  (alpha .numeric)  } 

42  (realJiteral) 

::=     (integer literal)  .  (integer literal) 

43  (integer  literal) 

::—     (digit)  {  (digit)  } 

44  (string  literal) 

::=     "  {  (char)  }  " 

45  (char) 

::=     am/  printable  character  except  '}' 

46  (digit) 

::=     0  |  1  |  2  |  3  |  4  |  5  J  6  |  7  |  8  |  9 

47  (letter) 

::=  a|b|c|d|e|f|g|h|i|j|k|l|m 

|  n|o|p|q|r|s|t|u|v|w|x|y|z 

j  A|B|C|D|E|F|G|H|I|J|K|L|M 

I  N|0|P|Q|R|S|T|U|V|W|X|Y|Z 

48  (alpha. numeric) 

v.—     (letter) 
I    (^aii) 


49      (text) 

::=     {  (char)  } 
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APPENDIX  B.  PROTOTYPE  EXAMPLE 

Early  in  the  development  of  the  PSDL  Editor,  a  small  prototype  created  by 
Dr.  Shing  was  used  for  testing  purposes.  This  prototype  consisted  of  a  few  operators, 
and  hence  did  not  present  a  sufficient  test  case  for  the  PSDL  Editor.  The  lack  of  size 
of  Dr.  Shing's  prototype  lead  to  the  creation  of  an  avionics.example  prototype. 

The  goal  of  the  avionics_example  prototype  was  to  use  as  many  features  of 
PSDL  as  possible  and  provide  a  medium  to  large  size  prototype  to  test  the  PSDL 
Editor.  Since  the  PSDL  Editor  has  limited  facilities  for  types  and  generics,  examples 
of  these  features  were  limited  or  non-existent.  In  addition,  no  attempt  was  made  to 
test  all  combinations  of  expression  evaluations. 

In  addition,  no  attempt  was  made  to  provide  a  full  avionics  suite.  The  example 
presented  is  not  intended  to  reflect  an  actual  avionics  suite,  although  aspects  of  the 
prototype  can  be  found  in  aircraft  that  are  currently  in  the  United  States  Air  Force 
inventory. 

1.       ARCHITECTURE 

Figure  55  represents  the  avionic  suite  that  is  modeled  in  the  prototype.  The 
avionic  suite  consists  of  a  six  subsystems:  Fire  Control  System  (FCS),  Radar  Sub- 
System  (RSS),  Navigation  SubSystem  (NSS),  Weapon  Subsystem  •(WSS),  Display 
Subsystem  (DSS),  and  the  Mass-Storage  Subsystem  (MSS).  The  FCS  contains  two 
dual-redundant  processors,  FCS.l  and  FCS_2.  The  RSS  contains  both  a  radar  an- 
tenna and  an  inertial  platform  on  the  antenna,  which  can  be  used  as  a  backup  navi- 
gation source.  Two  bomb  racks  are  provided  in  the  WSS. 

The  avionic  suite  contains  two  data  buses.  One  is  used  for  the  RSS  and  NSS. 
The  other  is  used  for  the  WSS,  DSS  and  MSS.  A  single  bus  controller  is  used  to 
coordinate  all  messages  traveling  over  the  buses.  The  FCS  performs  all  bus  controller 
activities.  Since  the  FCS  is  dual-redundant,  one  FCS  processor  is  designated  as  the 
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Figure  56.  Minor  Cycle  Task  Scheduling 

bus  controller  while  the  other  monitors  the  health  of  the  bus  controller.   If  the  bus 
controller  should  fail,  the  second  FCS  processor  takes  over  bus  controller  activities. 

All  tasks  performed  by  the  avionic  suite  are  scheduled  to  be  accomplished  at 
different  rates.  The  execution  of  each  processor  is  divided  into  minor  cycles  and  major 
cycles.  For  a  typical  avionic  suite,  the  processors  are  executed  at  50Hz.  Thus,  each 
minor  cycle  lasts  for  20  milliseconds.  A  major  cycle  would  consist  of  64  minor  cycles. 
All  tasks  are  expected  to  be  accomplished  in  a  major  cycle.  During  a  minor  cycle, 
tasks  from  two  rate  groups  are  performed.  This  is  depicted  in  Figure  56  where  each 
column  represents  a  minor  cycle.  During  each  minor  cycle,  tasks  from  the  50Hz  rate 
group  and  a  slower  rate  group  are  performed. 

2.       MAPPING  TO  PSDL 

Just  as  the  design  of  an  avionic  suite  would  start  with  a  high  level  diagram  and 
decompose  each  component  of  the  design,  the  prototype  consists  of  a  root  operator, 
avionics.example,  which  is  composed  of  a  PSDL  operator  for  each  subsystem.  In 
the  case  of  the  NSS,  a  simple  pass-thru  model  will  be  used.  No  additional  decompo- 
sition is  required  for  a  simple  operator.  Thus,  the  NSS  is  implemented  in  Ada.  The 
other  subsystems  are  more  complex,  and  thus,  are  decomposed  into  a  PSDL  graph 
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implementation. 

Although  no  software  base  is  provided  for  this  prototype  to  facilitate  the  execu- 
tion of  the  prototype,  two  additional  prototype  components  are  required  to  complete 
the  model.  An  environment-Simulation  operator  is  required  to  simulate  the  aircraft 
motion  as  well  as  the  target  environment  and  an  air.vehicle -interface  operator 
is  required  to  facilitate  the  displays  produced  by  the  display_sub_system  as  well  as 
providing  a  user  interface  for  switch  actions.  Both  of  these  operators  are  external  to 
the  avionic  suite  and  are  thus  represented  as  terminators  (square  boxes)  so  that  the 
execution  time  is  not  counted  against  the  avionic  suite. 

For  the  purposes  of  this  prototype,  the  timing  model  previously  discussed  is 
too  complex.  Instead,  tasks  will  be  accomplished  at  either  50Hz,  25Hz  or  1Hz.  Each 
subsystem  that  performs  tasks  at  different  rates  contains  a  mode  control  operator 
which  schedules  the  tasks. 

In  the  actual  avionic  suite,  each  processor  executes  in  parallel.  Tasks  within  a 
processor  are  performed  serially.  While  PSDL  does  not  preclude  the  parallel  execution 
of  operators,  CAPS  Release  1  was  implemented  on  a  single  processor.  This  prototype 
is  also  designed  to  be  executed  on  a  single  processor.  In  order  to  maintain  the  desired 
execution  rate  of  50Hz,  each  subsystem  is  assigned  an  execution  time  which  is  a 
fraction  of  a  minor  cycle  (reference  Figure  57).  Since  the  processing  of  each  subsystem 
is  simulated,  the  calculations  performed  can  be  greatly  simplified  in  order  meet  the 
timing  requirements. 

3.       PROTOTYPE 

The  decomposition  of  each  PSDL  operator  for  the  avionics_example  proto- 
type is  provided  in  Figures  58  through  64. 
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Figure  57.  Serializing  Multiple  Processors 
4.       CAPS  RELEASE  1  COMPATIBILITY 

Although  this  implementation  of  the  PSDL  Editor  incorporated  changes  to 
the  CAPS  Release  1  grammar,  an  attempt  was  made  to  schedule  the  prototype  using 
CAPS  Release  l27.  Before  the  prototype  can  be  scheduled,  a  successful  transla- 
tion must  be  accomplished.  It  was  found  that  the  translator  would  not  accept  the 
property  construct  added  to  the  PSDL  grammar.  Nor  did  the  translator  accept 
an  implementation  language  other  than  Ada28.  The  inclusion  of  operator  and  vertex 
identification  numbers  to  the  (opjname)  also  caused  compatibility  problems.  Since 
the  (opjname)  provided  in  an  (operator)  (component)  does  not  include  the  vertex 
identification  number,  where  the  (opJd)}s  used  in  the  (data-flow -diagram)  does, 


27Note  that  there  is  no  implied  compatibility  of  this  implementation  of  the  PSDL  Editor  with 
CAPS  Release  1.  This  experiment  was  intended  to  identify  compatibility  issues. 

28The  CAPS  Release  1  PSDL  Editor  did  not  accept  a  mixed  case  Ada.  An  all  upper  case  ADA 
was  accepted.  Additional  problems  encountered  with  the  CAPS  Release  1  PSDL  Editor  include  the 
finish  within  construct  and  Missing_Inf  o  containing  two  underscores  in  succession 
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Figure  58.  avionics_example  Root  Operator 
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Figure  59.  avionics.example  RSS  Operator 
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Figure  60.  avionics_example  DSS  Operator 
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Figure  61.  avionics_example  MSS  Operator 
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Figure  62.  avionics_example  WSS  Operator 
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Figure  63.  avionics_example  FCS  Operator 
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Figure  64.  avionics.example  Environment  Operator 
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each  of  these  (operator)  (component)^  are  reported  as  multiple  root  operators. 

After  using  a  text  editor  to  correct  these  problems,  no  additional  errors  were 
reported  by  the  translator.  However,  this  does  not  imply  that  there  are  no  other 
compatibility  issues.  Only  that  no  other  errors  were  detected.  At  this  point,  the 
prototype  was  scheduled.  Only  one  additional  error  was  detected  by  the  scheduler. 
The  scheduler  raised  a  TIME_INF0_ERR0R  exception  for  having  a  zero  MET  and  a  non- 
zero PERIOD. 

No  additional  testing  was  performed  beyond  obtaining  a  valid  schedule.  How- 
ever, additional  compatibility  issues  probably  still  exist  but  not  reported.  The  lack 
of  operator  and  stream  identification  numbers  within  (control -constrains)  will  most 
likely  cause  additional  problems. 

5.       LESSONS  LEARNED 

The  early  use  of  the  avionics_example  prototype  in  the  development  of  the 
PSDL  Editor  was  extremely  beneficial.  Problems  were  detected  with  the  PSDL  Editor 
that  required  major  rework  of  the  system  while  there  was  still  time  in  the  schedule 
to  accommodate  changes.  Specifically,  it  was  found  that  the  PSDL  Editor  required 
a  large  amount  of  time  to  perform  syntax  checks  and  took  an  enormous  amount  of 
system  memory.  In  addition,  the  protocol  used  to  exchange  information  between  the 
background  checker  and  the  graph  editor  failed  for  large  prototypes.  Neither  of  these 
problems  were  readily  apparent  from  the  use  of  smaller  test  cases. 

In  stepping  from  a  small  prototype  to  a  large  prototype,  it  was  apparent  that 
the  PSDL  Editor  required  too  much  time  to  traverse  the  prototype.  It  was  typical  to 
take  45  seconds  to  move  from  one  level  of  the  prototype  to  another.  Timing  analysis 
indicated  that  the  largest  component  of  this  delay  was  due  to  updating  the  attribute 
tree  maintained  by  the  background  checker,  which  uses  Synthesizer  Generator  routines 
to  maintain  the  attribute  tree  as  in  CAPS  Release  1.  However,  each  of  these  routines 
also  updated  the  syntax-directed  editor  window,  which  resulted  in  even  longer  delays. 
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The  syntax-directed  editor  window  is  not  used  in  this  version  of  the  PSDL  Editor,  and 
thus  resulted  in  wasted  processor  time.  System  performance  was  improved  through 
the  redesign  of  the  background  checker.  A  new  Ada/C  background  checker,  which 
did  not  use  the  Synthesizer  Generator  code,  is  now  used  to  maintain  the  prototype 
data  structure.  This  redesign  resulted  in  greatly  improved  performance  during  the 
traversal  of  the  prototype  and  significant  improvements  in  the  delays  encountered 
during  syntax  checks  and  save  operations. 

In  the  process  of  working  with  the  avionics_example,  it  was  found  that  the 
syntax-directed  editor  reported  being  out  of  memory  (virtual  memory  swap  space). 
The  problem  appeared  to  be  one  of  accumulation.  The  syntax-directed  editor  started 
with  a  reasonably  sized  workspace.  However,  as  the  user  traversed  the  prototype, 
the  memory  requirements  grew  until  the  available  swap  space  was  no  longer  able  to 
accommodate  the  program.  This  problem  is  now  solved  with  the  new  background 
checker. 

Between  the  background  checker  process  and  the  graph  editor  process,  two 
pipes  are  used  to  provide  bidirectional  communication.  The  protocol  used  to  com- 
municate worked  fine  for  small  prototypes.  However,  when  the  avionics_example 
prototype  was  used,  this  protocol  fell  apart.  The  error  resulted  from  the  maximum 
limit  on  the  size  of  read  and  write  operations  on  the  pipe.  Using  the  larger  prototype, 
this  limit  was  exceeded.  A  solution  was  obtained  by  transmitting  the  buffer  used  for 
inter-process  communication  using  multiple  packets  of  a  maximum  size  reflective  of 
the  pipe  limitations. 

Besides  these  errors,  modifications  to  the  user  interface  were  identified  to  im- 
prove user  interaction.  Once  again,  these  modifications  were  identified  after  repeated 
use  of  the  editor.  They  were  not  readily  apparent  from  the  entry  of  one  or  two 
operators. 
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6.       AVIONICS  EXAMPLE  PSDL  CODE 

The  following  is  the  PSDL  code  generated  by  the  PSDL  Editor  for  the  proto- 
type avionics_example. 
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APPENDIX  C.  PSDL  UNIQUE  SUFFIX 
NAMING  CONVENTION  MEMO 


From  berzinsOcs.nps.navy.mil  Thu  Jul  25  15:40:50  1996 

Return-Path :  <berzins@cs . nps . navy . mil> 

Received:  from  suns6.cs.nps.navy.mil  by  cs.nps.navy.mil  (4. l/SMI-4. 1) 

id  AA10627;  Thu,  25  Jul  96  15:40:50  PDT 

From:  berzins@cs.nps.navy.mil  (valdis  Berzins) 

Received:  by  suns6.cs.nps.navy.mil  (4.1)  id  AA08716;  Thu, 

25  Jul  96  15:40:43  PDT 
Date:  Thu,  25  Jul  96  15:40:43  PDT 

Message-Id :  <9607252240 . AA08716@suns6 . cs . nps . navy . mil> 
To:  berzins@cs.nps.navy.mil,  irwin@cs.nps.navy.mil, 

kbmoelle@cs . nps . navy . mil , 

luqi@cs .  nps .  navy . mil ,  mantak@cs .  nps .  navy .  mil , 

senrique@cs . nps . navy . mil 
Subject:  explanation  of  the  new  unique  suffix  conventions 
Status:  R0 

Unique  integer  suffixes  in  CAPS  Release  2 

Valdis  Berzins,  7/25/96 

To  properly  implement  PSDL  scope  rules, 

which  say  that  the  names  of  the  children  of  a 

composite  bubble  are  local  to  that  bubble, 

we  need  unique  internal  names  for  PSDL  operators . 

To  allow  multiple  instances  of  the  same  type  operation, 

we  also  need  unique  internal  names  for  graph  nodes . 

The  implementation  in  CAPS  Release  2  will  be  based  on  the 
following  conventions: 

1.  The  psdl  editor  will  supply  unique  internal  integer  suffixes 

for  the  names  of  stand-alone  PSDL  operators . 

These  suffixes  WILL  NOT  BE  VISIBLE  TO  THE  USER  OF  THE  EDITOR, 

and  will  be  supplied  automatically  in  generated  skeleton  code 

for  operators  with  IMPLEMENTATION  ADA. 

The  purpose  of  these  suffixes  is  to  allow  two  different 

composite  bubbles  to  have  children  of  the  same  name  without 

conflicts  between  the  Ada  module  names. 
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2.  Names  of  PSDL  data  types  will  not  have  automatically 
created  integer  suffixes,  because  they  are  not  needed. 

3.  Names  of  operations  of  PSDL  data  types  will  not  have 
automatically  created  integer  suffixes. 

This  implies  the  translator  does  not  have  to  resolve 
overloaded  operators. 

4.  The  psdl  editor  will  add  a  unique  integer  suffix  to 

each  operation  name  to  get  the  name  of  the  corresponding  graph  node, 
This  enables  multiple  instances  of  an  operation  of  a  data  type 
to  consistently  co-exist  in  the  same  graph. 

5.  In  release  2  the  integer  suffixes  will  be  unique  throughout  the 
entire  prototype  and  will  be  obtained  from  a  procedure  local  to  the 
editors  (because  there  will  be  no  DDB  in  release  2) . 

In  future  releases  the  suffixes  will  be  unique  across  all 
prototypes  developed  at  a  given  installation,  and  will  be  obtained 
from  a  unique  id  server  in  the  DDB. 

Some  consequences  of  these  conventions: 

A.  The  name  of  the  ada  operation  can  be  recovered  from 
the  name  of  the  graph  node  by  removing  a  trailing  numeric 
suffix  of  the  form  ("_"  digit+) . 

Note  that  the  name  of  the  graph  node  does  not  include 
the  optional  parameter  binding  part. 

B.  For  prototypes  created  under  caps  release  2, 

graph  nodes  corresponding  to  stand-alone  operators  will  have 
two  integer  suffixes,  but  only  the  second  one  need  be  recognized 
by  computations  in  translation.  The  schedulers  are  only  concerned 
with  graph  node  ids,  and  hence  are  not  affected  by  this  convention. 

C.  Graph  nodes  corresponding  to  operations  of  a  PSDL  data  type 
have  a  single  suffix.  This  suffix  enables  multiple  instances  of  a 
type  operation  to  appear  in  a  graph  without  danger  of  confusion. 

D.  Attributes  and  control  constraints  are  located  by  visual 
navigation  through  the  graphic  editor,  to  avoid  confusing  the 
correspondence  between  graph  nodes  and  control  constraints . 
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E.  PSDL  files  created  under  release  1  may  not  have  these  suffixes. 
The  concrete  parsing  rules  of  the  sde  should  recognize  such  cases, 
and  should  add  the  needed  suffixes  if  they  are  missing, 
to  enable  the  sde  to  read  old  psdl  files  (CAPS  release  1  format) . 

EXAMPLE 

Displayed  form  of  the  psdl,  with  explanatory  comments: 

OPERATOR  o  —  internal  name  o_13,  graph  node  o_13_20 
SPECIFICATION 

INPUT  a:  boolean 
OUTPUT  b:  integer 
END 
IMPLEMENTATION  ADA  END 

TYPE  t  —  internal  name  t 

OPERATOR  o  —  overloaded,  internal  name  o,  graph  node  t.o_21(b|) 
SPECIFICATION 

INPUT  x:  integer 
END 
OPERATOR  o  —  overloaded,  internal  name  o,  graph  node  t.o_22(|a) 
SPECIFICATION 

OUTPUT  y:  boolean 
END 
END 
IMPLEMENTATION  ADA  END 

OPERATOR  top 
SPECIFICATION 
END 
IMPLEMENTATION 

GRAPH  —  internal  form  of  the  graph,  whose  display  is  suppressed: 

VERTEX  o_13_20 

VERTEX  t.o_21(b|) 

VERTEX  t.o_22(|a) 

EDGE  a  t.o_22(|a)  ->  o_13_20 

EDGE  b  o_13_20  ->  t.o_21(b|) 
END 
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Displayed  form  of  the  graph: 


1 

1    t, 
1 

1 

o(la)        1 
1 

a 

1 
->    1 

0 

1         b 

i 

1 

->    1 

1 

t. 

1 

■o(b|)      1 

1 

I 
1 
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APPENDIX  D.  GRAPH  EDITOR  PROGRAM 

SOURCE  CODE 

The  following  is  the  complete  source  code  listing  of  the  graph  editor  portion 
of  the  PSDL  Editor.  The  original  graph  editor  source  code  was  developed  by  Captain 
Robert  Dixon,  USMC  [Ref.  13).  Additional  work  was  performed  by  Mr.  Douglas 
Lange  and  Mr.  Dagohoy  Anunciado  as  part  of  the  NPS  CS4520  (AY96Q4)  class 
project.  In  several  of  the  graph  editor  files,  the  authors  of  the  graph  editor  have 
adapted  code  written  by  others.  Such  instances  are  credited  within  the  source  files. 

For  a  starting  point,  ge_driver.C  contains  the  main()  routine  for  the  graph 
editor.  This  routine  is  called  by  the  syntax-directed  editor  to  start  the  graph  ed- 
itor. After  initialization  and  establishing  communications  with  the  syntax-directed 
editor,  the  routine  edit -graph  ()  is  called,  which  can  be  found  at  the  end  of  the  file 
graph_editor  .C. 


action_area.C,  186 
action_area.h,  185 

build_option. c,  188-189 
build_option.h,  187 

error. hip,  402 
exceptions .hip,  403 
exceptions-list  .hip,  404 

font-table. C,  191-192 
font_table.  h,  190 

ge_defs.h,  193 
ge_driver.C,  194 
ge_interface.h,  195-198 
ge_interface_labels.h,  199 
ge_utilities.c,  202-217 
ge_utilities.h,  200-201 
ge_utilities_debug.c,  220-234 


ge_utilities_debug.h,  218-219 
get_unique_id.c,  236 
get_unique_id.h,  235 
gettopshell.c,  238 
gettopshell.h,  237 
graph-editor. C,  240-270 
graph-editor  .h,  239 
graph_ob ject.C,  273-274 
graph_object.h,  271-272 
graph_object_list.C,  277-285 
graph_object_list.h,  275-276 

id-list. hip,  405 
inform_tool.hlp,  406 
initial_state. hip,  407 
inter_process_utilities .  c,  288-300 
inter_process_utilities.h,  286-287 

Makefile,  183-184 
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op_prop_formal_desc.hlp,  408        windows. C,  397-401 
op_prop_informal_desc.hlp,  409      windows. h,  396 
operator_object  .C,  305-317 
operator_object .h,  301-304 
operator_property. hip,  410 
operator_property_menu.C,  319-343 
operator_property_menu.h,  318 
operators. hip,  411 
out  put -guard,  hip,  412 

postpopup.c,  345-346 
postpopup.h,  344 
print. hip,  413 
psdl-grammar .hip,  414-416 

report-errors .  C,  348-350 
report-errors. h,  347 
resources. h,  351 

sde.c,  352-353 
sde_simulator .c,  355-357 
sde_simulator .h,  354 
setcursor .c,  359 
setcursor.h,  358 
spec_tool.hlp,  417 
spline-object. C,  362-370 
spline_object  .h,  360-361 
stream_object.C,  374-382 
stream-object.h,  371-373 
stream_property .hip,  418 
stream_property_menu.C,  384-390 
stream_property_menu.h,  383 
streams. hip,  419 

timer_list .hip,  420 
timer-tool. C,  392-393 
timer_tool. h,  391 
timers. hip,  421 
timers.tool.hlp,  422 
trigger_if_cond.hlp,  423 
types_tool.hlp,  424 

warning. C,  395 
warning. h,  394 
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APPENDIX  E.  INSTALLATION 

The  PSDL  Editor  consists  of  the  background  checker  and  the  graph  editor. 
This  appendix  describes  the  process  required  to  compile  the  graph  editor  as  well  as 
a  PSDL  Editor  driver,  used  for  debugging  the  graph  editor. 

1.  SOFTWARE  REQUIREMENTS 

Table  XIX  contains  the  software  and  version  numbers  used  to  generate  the 
graph  editor.  The  graph  editor  was  developed  on  a  Sun  workstation. 

2.  COMPILING  THE  GRAPH  EDITOR 

Contained  within  the  graph  editor  source  code  is  the  file  Makefile,  used  to 
build  the  graph  editor.  This  file  is  configured  to  be  executed  from  the  graph  editor 
source  code  directory,  which  is  a  subdirectory  of  a  PSDL  Editor  directory.  Prior  to 
generating  the  graph  editor,  the  user  should  set  the  default  directory  to  that  which 
contains  the  graph  editor  source  code.  The  graph  editor  can  be  generated  by  simply 
typing  "make"  at  the  Unix  prompt.  If  the  graph  editor  compiles  successfully,  the 
image  edit_graph  will  be  generated.  This  file  will  automatically  be  located  in  the 
parent  directory  In  addition,  the  image  sde  will  also  be  generated,  in  the  parent 
directory.  This  is  the  PSDL  Editor  driver  program,  used  to  test  the  graph  editor  in 

Table  XIX.  Support  Software 


Software  Version 


Operating  System     SunOS  Release  4.1.3 
C  Compiler  gcc  Version  2.6.3 

C++  Compiler         g++  Version  2.6.3 
Windows  XI 1  Version  5 

Motif  Version  1.1 
Make  Sun  Version  4.1 
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Table  XX.  Graph  Editor  Required  Files 

edit_graph  output -guard. hip 

error. hip  print. hip 

except ions. hip  psdl_grammar . hip 

except ions_list . hip  spec.tool . hip 

id_list.hlp  stream.property .hip 

inform_tool.hlp  streams. hip 

initial-State. hip  timer_list .hip 

op_prop_f ormal_desc . hip  timers . hip 

op_prop_inf ormal_desc . hip  timers_tool . hip 

operator.property . hip  trigger_if  _cond .  hip 

operators. hip  types_tool.hlp 


a  standalone  fashion. 

Table  XX  provides  a  list  of  the  graph  editor  files  required  to  support  the 
PSDL  Editor.  The  file  edit_graph  is  the  image  which  executes  the  graph  editor. 
The  remainder  of  the  files  are  help  files,  which  are  expected  to  be  located  in  the 
directory  from  which  the  graph  editor  is  executed. 

3.       X  WINDOW  SYSTEM  CUSOMIZATION 

The  PSDL  Editor  uses  Motif  to  build  the  graph  editor.  Consequentially,  the 
X  Window  System  initialization  protocol  used  to  define  window  parameters  can  be 
used  with  the  PSDL  Editor  [Ref.  15].  These  parameters  can  be  defined  in  the  file 
.Xresources-color29,  located  in  your  home  directory30  Table  XXI  provides  sample 
declarations  to  set  the  default  window  size  for  the  graph  editor  as  well  as  for  defining 
the  delete  key  to  work  like  the  backspace  key. 


290r  in  the  file  .Xresources-mono  for  non-color  systems. 

30Since  this  is  a  "dot"  file,  it  will  not  appear  under  the  Unix  "Is"  command.  "Dot"  files  can  be 


seen  by  using  the  -a  flag  (e.g.,  "Is  -a"). 
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Table  XXI.  X  Window  System  Initialization 

edit_graph*geometry:    =900x700 

edit _graph*XmText .translations :    #override\n\ 

<Key>osfDelete :    delete-previous-character () 
edit_graph*XmTextField . translations :    #overr ide\n\ 

<Key>osf Delete :    delete-previous-character () 
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